Does open-codex-computer-use auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is open-codex-computer-use free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Automation

Plugin

open-codex-computer-use

Interested in Browser Use? Check out open-browser-use. open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.

FLOW.md

ifuryst@ifuryst

GitHub

Plugin Signal72/100Solid

maintained98

capable23

documented100

adopted69

Install

$ npx -y skills add iFurySt/open-codex-computer-use --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

Node Bash Swift Linux GitHub

+4 tags

Anthropic OpenAI Gemini MCP

1,673

Stars

156

Forks

Active

Maintenance

Swift

Language

MIT

License

3d ago

Last commit

3mo ago

Created

Repo: iFurySt/open-codex-computer-use

In this plugin

1 MCP 1 skill

MCP
- open-computer-use
skills
- open-computer-use

See everything inside

What's inside

Skills

/open-computer-usePlatform-neutral guidance for using Open Computer Use, the open-source Computer Use MCP server and CLI for macOS, Linux, and Windows. Use when an agent needs to install, verify, troubleshoot, configure, or operate Open Computer Use through its native CLI, stdio MCP server, or

MCP

open-computer-uselaunch-open-computer-use.sh

Badges

README

Read on GitHub

open-computer-use

[!TIP] Interested in Browser Use? Check out open-browser-use.

open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.

This project was inspired by OpenAI's Codex Computer Use. It showed that non-intrusive CUA can be built on top of Accessibility, so I decided to build an open-source version.

I started this repo with my harness template, a template for quickly spinning up AI-first projects. It has been one of our most useful workflows lately, especially for nearly 100% AI-generated projects. I also wrote a post about the methodology behind it.

Demos

Codex App and Codex CLI

open-computer-use used as Computer Use in Codex App and Codex CLI, matching the official experience.

Gemini CLI

https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d

Gemini CLI connects to open-computer-use through MCP and runs full Computer Use actions.

Linux

https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66

open-computer-use running on Linux.

Quick Start

npm i -g open-computer-use

The npm package also exposes ocu as the short CLI alias.

[!IMPORTANT] The macOS runtime requires macOS 14.0 or later.

On macOS, run it once and grant Accessibility and Screen Recording. Windows and Linux do not need this step.

open-computer-use
# or
ocu

Before using it, install it into your agent:

# Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp

Or add it to your own client manually:

{
  "mcpServers": {
    "open-computer-use": {
      "command": "open-computer-use",
      "args": ["mcp"]
    }
  }
}

Skill

Install the skill directly:

# Install for Codex
npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y
npx skills ls -g -a codex | rg 'open-computer-use'

Install for Claude Code:

npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y

Update an existing global install, including the Codex install created above:

npx skills update open-computer-use -g -y

You can also manually download and install the open-computer-use skill.

Besides the MCP JSON config above, you can also use the built-in commands:

# Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp
ocu install-codex-mcp

# Install as a Codex plugin, mainly for Codex App
open-computer-use install-codex-plugin

# Install into Claude Code by writing to ~/.claude.json
open-computer-use install-claude-mcp

# Install into Gemini CLI for the current project by writing to ./.gemini/settings.json
open-computer-use install-gemini-mcp

# Install into Gemini CLI user config instead
open-computer-use install-gemini-mcp --scope user

# Install into opencode by writing to ~/.config/opencode/opencode.json (or the active config file)
open-computer-use install-opencode-mcp

# Call a single Computer Use tool and print the MCP-style JSON result
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'

# Run a sequence in one process so element_index state can be reused
# Sequence runs sleep 1s between successful operations by default
open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5

# Check permissions; onboarding only opens when something is missing
open-computer-use doctor

# Run local validation from a source checkout
make smoke
OPEN_COMPUTER_USE_STRESS_LOOPS=20 make stress
make agent-smoke
make agent-smoke SCENARIO=fixture-full
node ./scripts/run-agent-smoke-tests.mjs --agents=claude,codex --command=open-computer-use
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=claude,codex --command=open-computer-use
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=claude,codex --command=open-computer-use
OPEN_COMPUTER_USE_HERMES_PROVIDER=anthropic OPEN_COMPUTER_USE_HERMES_MODEL=claude-opus-4-20250514 make agent-smoke AGENTS=hermes SCENARIO=fixture-full
node ./scripts/run-agent-smoke-tests.mjs --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514 --hermes-max-turns=12

# Show help
open-computer-use -h
ocu -h

Cursor Motion

Cursor Motion is an open-source cursor motion system for macOS, based on public information shared by members of the Software.Inc team. You can download the app from the Releases page.

Star History

License

MIT. Third-party attribution is listed in THIRD_PARTY_NOTICES.md.

File tree

389

iFurySt/open-codex-computer-useView on GitHub

.agents/
  plugins/
    marketplace.json
.gitattributes
.github/
  workflows/
    release.yml
.gitignore
AGENTS.md
apps/
  OpenComputerUse/
    Sources/
      OpenComputerUse/
        MacOSAppAgentProxy.swift
        MCPAppRuntime.swift
        OpenComputerUseMain.swift
        PermissionOnboardingApp.swift
  OpenComputerUseFixture/
    Sources/
      OpenComputerUseFixture/
        main.swift
  OpenComputerUseLinux/
    go.mod
    main_test.go
    main.go
    runtime_test.py
    runtime.py
  OpenComputerUseSmokeSuite/
    Sources/
      OpenComputerUseSmokeSuite/
        main.swift
  OpenComputerUseWindows/
    go.mod
    main_test.go
    main.go
    runtime.ps1
artifacts/
  tool-comparisons/
    20260417-focus-behavior/
      computer-use/
        get_app_state-activity-monitor.json
      open-codex-computer-use/
        click-activity-monitor-coordinate.json
        get_app_state-activity-monitor.json
      README.md
assets/
  app-icons/
    open-computer-use-1024.png
CLAUDE.md
CODEOWNERS
CONTRIBUTING.md
docs/
  ARCHITECTURE.md
  CICD.md
  design-docs/
    core-beliefs.md
    index.md
  DESIGN.md
  exec-plans/
    active/
      .gitkeep
      20260417-official-tool-alignment.md
      20260417-permission-onboarding-app.md
      20260418-standalone-cursor-lab.md
      20260419-official-cursor-motion-reconstruction.md
      20260420-cursor-slider-binary-investigation.md
      20260422-linux-computer-use-runtime.md
      20260422-remaining-tool-official-alignment.md
      20260422-windows-computer-use-runtime.md
      20260423-cross-platform-npm-distribution.md
    completed/
      .gitkeep
      20260417-2115-npm-distribution.md
      20260417-nonintrusive-computer-use.md
      20260417-open-source-computer-use-reverse-engineering.md
      20260417-open-source-swift-computer-use.md
      20260417-visual-cursor-overlay.md
      20260419-overlay-official-cursor-motion-alignment.md
      20260419-standalone-cursor-from-python-reconstruction.md
      20260419-visual-cursor-pose-dynamics-refactor.md
      20260507-feishu-electron-snapshot-stability.md
      20260722-add-sky-click.md
      20260722-configurable-click-method.md
      20260723-preserve-sky-click-focus.md
    README.md
    tech-debt-tracker.md
    templates/
      execution-plan.md
  FRONTEND.md
  generated/
    readme-assets/
      cursor-motion-demo-cover.png
      open-computer-use-demo-cover.png
    README.md
  histories/
    2026-04/
      20260417-1156-open-source-computer-use-research-foundation.md
      20260417-1258-prepare-initial-commit.md
      20260417-1325-open-source-swift-computer-use.md
      20260417-1504-hide-dock-icon-for-onboarding-app.md
      20260417-1510-nonintrusive-computer-use.md
      20260417-1532-install-open-computer-use-plugin.md
      20260417-1544-logo-explorations.md
      20260417-1554-rename-open-computer-use-identifiers.md
      20260417-1619-add-codex-mitm-dump-script.md
      20260417-1639-document-codex-local-runtime-logs.md
      20260417-1807-move-computer-use-cli-into-scripts.md
      20260417-1812-normalize-repo-path-links.md
      20260417-1816-align-computer-use-tool-results.md
      20260417-1901-visual-cursor-overlay.md
      20260417-1936-bump-open-computer-use-to-0.1.1.md
      20260417-2043-bump-open-computer-use-to-0.1.2.md
      20260417-2122-fix-permission-panel-tracking.md
      20260417-2126-npm-distribution-and-publish.md
      20260417-2130-window-aware-cursor-path-selection.md
      20260417-2132-add-mcp-json-config-to-readme.md
      20260417-2138-bump-open-computer-use-to-0.1.3.md
      20260417-2148-fix-npm-bin-symlink-launcher.md
      20260417-2154-bump-open-computer-use-to-0.1.4.md
      20260417-2155-doctor-launches-permission-onboarding.md
      20260417-2206-enable-npm-trusted-publishing.md
      20260417-2210-fix-npm-release-auth-and-readme-cleanup.md
      20260417-2214-enable-tag-release-and-bump-to-0.1.5.md
      20260417-2215-fix-bundle-display-name-and-icon.md
      20260417-2218-fix-npm-auth-mode-selection.md
      20260417-2228-improve-npm-postinstall-next-steps.md
      20260417-2235-fix-cli-help-and-version-flags.md
      20260417-2246-bump-open-computer-use-to-0.1.6.md
      20260417-2255-add-codex-mcp-installer.md
      20260417-2310-add-claude-mcp-installer.md
      20260417-2318-fix-release-build-on-xcode-26.md
      20260417-2326-bump-open-computer-use-to-0.1.9.md
      20260417-2340-bump-open-computer-use-to-0.1.7.md
      20260417-2350-bump-open-computer-use-to-0.1.8.md
      20260417-2350-fix-permission-accessory-panel-ordering.md
      20260417-2358-simplify-readme.md
      20260418-0014-translate-readme-to-english.md
      20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md
      20260418-0035-bump-open-computer-use-to-0.1.10.md
      20260418-0100-bump-open-computer-use-to-0.1.11.md
      20260418-1430-standalone-cursor-lab.md
      20260419-1320-deepen-official-cursor-motion-analysis.md
      20260419-1333-add-binary-guided-cursor-motion-re-demo.md
      20260419-2010-align-overlay-motion-with-official-model.md
      20260419-2135-refine-permission-panel-transition-and-back-button.md
      20260419-2203-document-release-guide.md
      20260419-2205-bump-open-computer-use-to-0.1.12.md
      20260419-2219-refresh-official-overlay-arrow-findings.md
      20260419-2300-add-standalone-cursor-from-python-reconstruction.md
      20260420-1151-investigate-cursor-slider-binary-mapping.md
      20260420-1238-confirm-official-overlay-trigger-matrix.md
      20260420-1416-add-computer-use-cli-call-seq.md
      20260420-1558-fix-permission-relaunch-misdetection.md
      20260420-1608-unify-open-computer-use-app-identity.md
      20260420-1620-bump-open-computer-use-to-0.1.14.md
      20260420-1740-prepare-developer-id-signing-assets.md
      20260420-1745-bump-open-computer-use-to-0.1.13.md
      20260420-1758-enable-cursor-motion-notarization.md
      20260420-1806-remove-python-from-installers.md
      20260420-1808-bump-open-computer-use-to-0.1.17.md
      20260420-1810-bump-open-computer-use-to-0.1.19.md
      20260420-1815-bump-open-computer-use-to-0.1.15.md
      20260420-1818-fix-ci-signing-identity-fallback.md
      20260420-1825-clarify-youtube-demo-links-in-readme.md
      20260420-1828-fix-hardened-runtime-for-notarization.md
      20260420-1828-fix-release-codesign-identity-resolution.md
      20260420-1834-remove-rsync-from-plugin-installer.md
      20260420-1836-bump-open-computer-use-to-0.1.18.md
      20260420-1842-bump-open-computer-use-to-0.1.16.md
      20260420-1845-bump-open-computer-use-to-0.1.20.md
      20260420-1908-refresh-node24-compatible-actions.md
      20260420-2028-shrink-app-icon-safe-area.md
      20260420-2033-integrate-set-value-visual-cursor.md
      20260421-1113-fix-initial-visual-cursor-approach.md
      20260421-1210-bump-open-computer-use-to-0.1.21.md
      20260421-1211-align-cursor-initial-origin.md
      20260421-1611-bump-open-computer-use-to-0.1.22.md
      20260421-1624-document-official-computer-use-sender-auth.md
      20260421-1659-archive-official-computer-use-bundles.md
      20260421-2058-add-native-call-command.md
      20260421-2103-bump-open-computer-use-to-0.1.23.md
      20260421-2120-disable-click-global-pointer-default.md
      20260422-1015-bump-open-computer-use-to-0.1.24.md
      20260422-1050-align-set-value-settable-boundary.md
      20260422-1055-bump-open-computer-use-to-0.1.25.md
      20260422-1057-preserve-visual-cursor-idle-state.md
      20260422-1113-align-remaining-tool-defaults.md
      20260422-1115-bump-open-computer-use-to-0.1.26.md
      20260422-1124-add-textedit-overlay-sequence.md
      20260422-1150-bump-open-computer-use-to-0.1.27.md
      20260422-1156-align-runtime-cursor-speed.md
      20260422-1205-harden-npm-release-retry.md
      20260422-1234-bump-open-computer-use-to-0.1.28.md
      20260422-1246-add-windows-computer-use-runtime.md
      20260422-1338-fix-visual-cursor-coordinate-space.md
      20260422-1403-sequence-call-inter-operation-sleep.md
      20260422-1447-add-language-mirroring-rule-to-agents.md
      20260422-1452-sanitize-example-paths-and-sample-app-names.md
      20260422-1459-clarify-english-reply-rule.md
      20260422-1507-add-targeted-click-fallback.md
      20260422-1551-bump-open-computer-use-to-0.1.29.md
      20260422-1601-require-pull-latest-before-push.md
      20260422-1638-shorten-visual-cursor-idle-timeout.md
      20260422-1649-fix-visual-cursor-target-z-order.md
      20260422-1658-bump-v0-1-30-and-release-notes-rule.md
      20260422-1705-build-warning-cleanup.md
      20260422-1705-fix-targeted-mouse-coordinate-space.md
      20260422-1720-switch-visual-cursor-idle-to-rotate-shake.md
      20260422-1737-add-bgclick-free-research.md
      20260422-1759-bump-open-computer-use-to-0.1.32.md
      20260422-1816-add-gemini-opencode-mcp-installers.md
      20260422-1828-bump-open-computer-use-to-0.1.33.md
      20260422-1830-add-star-history-readme-chart.md
      20260422-1952-add-gemini-cli-demo-video.md
      20260422-2036-add-linux-computer-use-runtime.md
      20260423-1151-add-cross-platform-npm-packages.md
      20260423-1236-auto-linux-codex-mcp-session-env.md
      20260423-1417-organize-readme-demo-videos.md
    2026-05/
      20260503-1731-app-scoped-permission-agent.md
      20260506-1045-release-0.1.37.md
      20260506-1058-release-0.1.38.md
      20260507-1534-shrink-denylist-to-password-managers.md
      20260507-1553-bump-open-computer-use-to-0.1.39.md
      20260507-1638-feishu-electron-snapshot-stability.md
      20260507-1646-release-0.1.40.md
      20260507-1747-align-electron-snapshot-rendering.md
      20260507-1825-polish-accessibility-formatting.md
      20260507-1835-release-0.1.42.md
      20260507-1846-webarea-container-rendering.md
      20260507-1849-release-0.1.43.md
      20260507-1905-require-ax-window-for-snapshot.md
      20260507-1910-release-0.1.44.md
      20260507-1926-release-0.1.45.md
      20260507-1935-release-0.1.46.md
      20260507-1945-local-validation-before-release.md
      20260507-1958-recover-hidden-electron-window.md
      20260507-2004-align-tree-root-indentation.md
      20260507-2010-render-ax-placeholder.md
      20260507-2015-document-official-state-rendering.md
      20260507-2017-avoid-counter-text-merge.md
      20260507-2023-render-links-as-markdown.md
      20260507-2026-preserve-link-role-for-markdown.md
      20260507-2040-refresh-permission-onboarding.md
      20260507-2047-list-apps-frontmost.md
      20260507-2115-restart-stale-app-agent.md
      20260508-1022-align-feishu-state-wrappers.md
      20260508-1045-headless-smoke-fixture.md
      20260508-1203-release-0.1.47.md
      20260508-1508-bound-screenshot-result-size.md
      20260508-1518-release-0.1.48.md
      20260510-1129-readme-browser-use-tip.md
      20260511-1029-fix-open-panel-file-click.md
      20260511-1034-release-0.1.49.md
      20260512-1817-fix-macos-unicode-type-text.md
      20260512-1852-avoid-synthetic-row-side-action-clicks.md
      20260513-1413-release-0.1.50.md
      20260516-1117-open-computer-use-skill.md
      20260520-1641-fix-permission-onboarding-stale-panel.md
      20260520-1720-release-0.1.51.md
      20260526-1126-fix-cli-element-index.md
    2026-06/
      20260601-2002-agent-stress-validation.md
      20260603-2201-release-0.1.52.md
      20260605-1640-unify-snapshot-text-limit.md
      20260611-1608-release-0.1.53.md
      20260626-2206-add-ocu-cli-alias.md
      20260626-2216-release-0.1.54.md
      20260630-1635-unify-snapshot-tree-budget-defaults.md
    2026-07/
      20260708-1044-bump-v0.2.0.md
      20260710-1659-document-macos-14-requirement.md
      20260716-1548-preserve-anonymous-web-actions.md
      20260720-1736-bump-v0.2.1.md
      20260722-1718-add-configurable-click-method.md
      20260723-1655-preserve-sky-click-focus.md
      20260727-1425-bump-v0.3.0.md
      20260730-1431-preserve-generic-action-boundaries.md
      20260730-1608-bump-v0.3.1.md
      20260730-1637-enforce-english-github-release-notes.md
    2026-08/
      20260808-0409-fix-linux-atspi-interface-detection.md
    20260722-1905-add-sky-click.md
    template.md
  HISTORY_GUIDE.md
  PLANS_GUIDE.md
  PRODUCT_SENSE.md
  product-specs/
    index.md
  QUALITY_SCORE.md
  references/
    codex-computer-use-cli.md
    codex-computer-use-reverse-engineering/
      assets/
        extracted-2026-04-17/
          appicon-cursor-dark.png
          appicon-cursor.png
          hint-arrow.png
          menubar-cursor.png
          software-cursor-computeruse.png
          software-cursor-slimcore.png
        extracted-2026-04-19/
          official-software-cursor-pointer-raw-crop.png
          official-software-cursor-window-252-center-crop.png
          official-software-cursor-window-252.png
          official-software-cursor-window.png
        official-bundles/
          computer-use/
            1.0.750.zip
            1.0.755.zip
            README.md
            SHA256SUMS
        README.md
      background-click-free-tooling.md
      baseline-architecture.md
      internal-ipc-surface.md
      packaging-and-lifecycle-integration.md
      permission-onboarding.md
      README.md
      runtime-and-host-dependencies.md
      software-cursor-motion-model.md
      software-cursor-motion-reconstruction.md
      software-cursor-overlay.md
      software-cursor-slider-parameter-investigation.md
      state-rendering-1.0.770.md
      tool-call-samples-2026-04-17.md
    codex-local-runtime-logs.md
    codex-network-capture.md
    macos-skylight-background-click.md
    README.md
  releases/
    feature-release-notes.md
    github/
      TEMPLATE.md
      v0.2.0.md
      v0.2.1.md
      v0.3.0.md
      v0.3.1.md
    README.md
    RELEASE_GUIDE.md
  RELIABILITY.md
  REPO_COLLAB_GUIDE.md
  SECURITY.md
  SUPPLY_CHAIN_SECURITY.md
examples/
  textedit-overlay-seq.json
experiments/
  CursorMotion/
    README.md
    Sources/
      CursorMotion/
        CursorGlyphCalibration.swift
        CursorLabRootView.swift
        CursorMotionApp.swift
        CursorMotionModel.swift
        SynthesizedCursorGlyphView.swift
  StandaloneCursor/
    README.md
    Sources/
      StandaloneCursor/
        StandaloneCursorApp.swift
        StandaloneCursorRootView.swift
      StandaloneCursorSupport/
        StandaloneCursorModel.swift
    Tests/
      StandaloneCursorSupportTests/
        StandaloneCursorSupportTests.swift
LICENSE
Makefile
package.json
Package.swift
packages/
  OpenComputerUseKit/
    Sources/
      OpenComputerUseKit/
        AccessibilitySnapshot.swift
        AppDiscovery.swift
        ComputerUseService.swift
        ComputerUseToolDispatcher.swift
        CursorMotionModel.swift
        Errors.swift
        FixtureBridge.swift
        InputSimulation.swift
        KeyMapping.swift
        MCPServer.swift
        OpenComputerUseCLI.swift
        OpenComputerUseVersion.swift
        Permissions.swift
        SkyClickSimulation.swift
        SkyLightSPI.swift
        SoftwareCursorGlyphRenderer.swift
        SoftwareCursorOverlay.swift
        ToolDefinitions.swift
        ToolResult.swift
    Tests/
      OpenComputerUseKitTests/
        OpenComputerUseKitTests.swift
        SkyClickLiveTests.swift
plugins/
  open-computer-use/
... 66 more

FAQ

open-codex-computer-use is a Claude Code plugin with 1 hand-picked skill for automation work, indexed on Flowy. Install it with the command on its page. It includes open-computer-use. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is open-codex-computer-use?: Interested in Browser Use? Check out open-browser-use. open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.
How do I install open-codex-computer-use?: Run these in Claude Code: npx -y skills add iFurySt/open-codex-computer-use --agent claude-code. Then prompt normally.
Does open-codex-computer-use auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is open-codex-computer-use free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Automation

Plugin

open-codex-computer-use

FLOW.md

ifuryst@ifuryst

GitHub

Plugin Signal72/100Solid

maintained98

capable23

documented100

adopted69

Install

$ npx -y skills add iFurySt/open-codex-computer-use --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

Node Bash Swift Linux GitHub

+4 tags

Anthropic OpenAI Gemini MCP

1,673

Stars

156

Forks

Active

Maintenance

Swift

Language

MIT

License

3d ago

Last commit

3mo ago

Created

Repo: iFurySt/open-codex-computer-use

In this plugin

1 MCP 1 skill

MCP
- open-computer-use
skills
- open-computer-use

See everything inside

What's inside

Skills

MCP

open-computer-uselaunch-open-computer-use.sh

Badges

README

Read on GitHub

open-computer-use

[!TIP] Interested in Browser Use? Check out open-browser-use.

open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.

This project was inspired by OpenAI's Codex Computer Use. It showed that non-intrusive CUA can be built on top of Accessibility, so I decided to build an open-source version.

Demos

Codex App and Codex CLI

open-computer-use used as Computer Use in Codex App and Codex CLI, matching the official experience.

Gemini CLI

https://github.com/user-attachments/assets/eacb3b15-f939-46c7-b3b3-6f876977a58d

Gemini CLI connects to open-computer-use through MCP and runs full Computer Use actions.

Linux

https://github.com/user-attachments/assets/e036b1c8-2200-4896-abd4-19225915cf66

open-computer-use running on Linux.

Quick Start

npm i -g open-computer-use

The npm package also exposes ocu as the short CLI alias.

[!IMPORTANT] The macOS runtime requires macOS 14.0 or later.

On macOS, run it once and grant Accessibility and Screen Recording. Windows and Linux do not need this step.

open-computer-use
# or
ocu

Before using it, install it into your agent:

# Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp

Or add it to your own client manually:

{
  "mcpServers": {
    "open-computer-use": {
      "command": "open-computer-use",
      "args": ["mcp"]
    }
  }
}

Skill

Install the skill directly:

# Install for Codex
npx skills add iFurySt/open-codex-computer-use -g -a codex --skill open-computer-use -y
npx skills ls -g -a codex | rg 'open-computer-use'

Install for Claude Code:

npx skills add iFurySt/open-codex-computer-use -g -a claude-code --skill open-computer-use -y

Update an existing global install, including the Codex install created above:

npx skills update open-computer-use -g -y

You can also manually download and install the open-computer-use skill.

Besides the MCP JSON config above, you can also use the built-in commands:

# Install into Codex by writing to ~/.codex/config.toml
open-computer-use install-codex-mcp
ocu install-codex-mcp

# Install as a Codex plugin, mainly for Codex App
open-computer-use install-codex-plugin

# Install into Claude Code by writing to ~/.claude.json
open-computer-use install-claude-mcp

# Install into Gemini CLI for the current project by writing to ./.gemini/settings.json
open-computer-use install-gemini-mcp

# Install into Gemini CLI user config instead
open-computer-use install-gemini-mcp --scope user

# Install into opencode by writing to ~/.config/opencode/opencode.json (or the active config file)
open-computer-use install-opencode-mcp

# Call a single Computer Use tool and print the MCP-style JSON result
open-computer-use call list_apps
ocu call list_apps
open-computer-use call get_app_state --args '{"app":"TextEdit"}'

# Run a sequence in one process so element_index state can be reused
# Sequence runs sleep 1s between successful operations by default
open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
open-computer-use call --calls-file examples/textedit-overlay-seq.json --sleep 0.5

# Check permissions; onboarding only opens when something is missing
open-computer-use doctor

# Run local validation from a source checkout
make smoke
OPEN_COMPUTER_USE_STRESS_LOOPS=20 make stress
make agent-smoke
make agent-smoke SCENARIO=fixture-full
node ./scripts/run-agent-smoke-tests.mjs --agents=claude,codex --command=open-computer-use
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=claude,codex --command=open-computer-use
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=claude,codex --command=open-computer-use
OPEN_COMPUTER_USE_HERMES_PROVIDER=anthropic OPEN_COMPUTER_USE_HERMES_MODEL=claude-opus-4-20250514 make agent-smoke AGENTS=hermes SCENARIO=fixture-full
node ./scripts/run-agent-smoke-tests.mjs --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514
node ./scripts/run-agent-smoke-tests.mjs --scenario=fixture-full --agents=hermes --hermes-provider=anthropic --hermes-model=claude-opus-4-20250514 --hermes-max-turns=12

# Show help
open-computer-use -h
ocu -h

Cursor Motion

Cursor Motion is an open-source cursor motion system for macOS, based on public information shared by members of the Software.Inc team. You can download the app from the Releases page.

Star History

License

MIT. Third-party attribution is listed in THIRD_PARTY_NOTICES.md.

File tree

389

iFurySt/open-codex-computer-useView on GitHub

.agents/
  plugins/
    marketplace.json
.gitattributes
.github/
  workflows/
    release.yml
.gitignore
AGENTS.md
apps/
  OpenComputerUse/
    Sources/
      OpenComputerUse/
        MacOSAppAgentProxy.swift
        MCPAppRuntime.swift
        OpenComputerUseMain.swift
        PermissionOnboardingApp.swift
  OpenComputerUseFixture/
    Sources/
      OpenComputerUseFixture/
        main.swift
  OpenComputerUseLinux/
    go.mod
    main_test.go
    main.go
    runtime_test.py
    runtime.py
  OpenComputerUseSmokeSuite/
    Sources/
      OpenComputerUseSmokeSuite/
        main.swift
  OpenComputerUseWindows/
    go.mod
    main_test.go
    main.go
    runtime.ps1
artifacts/
  tool-comparisons/
    20260417-focus-behavior/
      computer-use/
        get_app_state-activity-monitor.json
      open-codex-computer-use/
        click-activity-monitor-coordinate.json
        get_app_state-activity-monitor.json
      README.md
assets/
  app-icons/
    open-computer-use-1024.png
CLAUDE.md
CODEOWNERS
CONTRIBUTING.md
docs/
  ARCHITECTURE.md
  CICD.md
  design-docs/
    core-beliefs.md
    index.md
  DESIGN.md
  exec-plans/
    active/
      .gitkeep
      20260417-official-tool-alignment.md
      20260417-permission-onboarding-app.md
      20260418-standalone-cursor-lab.md
      20260419-official-cursor-motion-reconstruction.md
      20260420-cursor-slider-binary-investigation.md
      20260422-linux-computer-use-runtime.md
      20260422-remaining-tool-official-alignment.md
      20260422-windows-computer-use-runtime.md
      20260423-cross-platform-npm-distribution.md
    completed/
      .gitkeep
      20260417-2115-npm-distribution.md
      20260417-nonintrusive-computer-use.md
      20260417-open-source-computer-use-reverse-engineering.md
      20260417-open-source-swift-computer-use.md
      20260417-visual-cursor-overlay.md
      20260419-overlay-official-cursor-motion-alignment.md
      20260419-standalone-cursor-from-python-reconstruction.md
      20260419-visual-cursor-pose-dynamics-refactor.md
      20260507-feishu-electron-snapshot-stability.md
      20260722-add-sky-click.md
      20260722-configurable-click-method.md
      20260723-preserve-sky-click-focus.md
    README.md
    tech-debt-tracker.md
    templates/
      execution-plan.md
  FRONTEND.md
  generated/
    readme-assets/
      cursor-motion-demo-cover.png
      open-computer-use-demo-cover.png
    README.md
  histories/
    2026-04/
      20260417-1156-open-source-computer-use-research-foundation.md
      20260417-1258-prepare-initial-commit.md
      20260417-1325-open-source-swift-computer-use.md
      20260417-1504-hide-dock-icon-for-onboarding-app.md
      20260417-1510-nonintrusive-computer-use.md
      20260417-1532-install-open-computer-use-plugin.md
      20260417-1544-logo-explorations.md
      20260417-1554-rename-open-computer-use-identifiers.md
      20260417-1619-add-codex-mitm-dump-script.md
      20260417-1639-document-codex-local-runtime-logs.md
      20260417-1807-move-computer-use-cli-into-scripts.md
      20260417-1812-normalize-repo-path-links.md
      20260417-1816-align-computer-use-tool-results.md
      20260417-1901-visual-cursor-overlay.md
      20260417-1936-bump-open-computer-use-to-0.1.1.md
      20260417-2043-bump-open-computer-use-to-0.1.2.md
      20260417-2122-fix-permission-panel-tracking.md
      20260417-2126-npm-distribution-and-publish.md
      20260417-2130-window-aware-cursor-path-selection.md
      20260417-2132-add-mcp-json-config-to-readme.md
      20260417-2138-bump-open-computer-use-to-0.1.3.md
      20260417-2148-fix-npm-bin-symlink-launcher.md
      20260417-2154-bump-open-computer-use-to-0.1.4.md
      20260417-2155-doctor-launches-permission-onboarding.md
      20260417-2206-enable-npm-trusted-publishing.md
      20260417-2210-fix-npm-release-auth-and-readme-cleanup.md
      20260417-2214-enable-tag-release-and-bump-to-0.1.5.md
      20260417-2215-fix-bundle-display-name-and-icon.md
      20260417-2218-fix-npm-auth-mode-selection.md
      20260417-2228-improve-npm-postinstall-next-steps.md
      20260417-2235-fix-cli-help-and-version-flags.md
      20260417-2246-bump-open-computer-use-to-0.1.6.md
      20260417-2255-add-codex-mcp-installer.md
      20260417-2310-add-claude-mcp-installer.md
      20260417-2318-fix-release-build-on-xcode-26.md
      20260417-2326-bump-open-computer-use-to-0.1.9.md
      20260417-2340-bump-open-computer-use-to-0.1.7.md
      20260417-2350-bump-open-computer-use-to-0.1.8.md
      20260417-2350-fix-permission-accessory-panel-ordering.md
      20260417-2358-simplify-readme.md
      20260418-0014-translate-readme-to-english.md
      20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md
      20260418-0035-bump-open-computer-use-to-0.1.10.md
      20260418-0100-bump-open-computer-use-to-0.1.11.md
      20260418-1430-standalone-cursor-lab.md
      20260419-1320-deepen-official-cursor-motion-analysis.md
      20260419-1333-add-binary-guided-cursor-motion-re-demo.md
      20260419-2010-align-overlay-motion-with-official-model.md
      20260419-2135-refine-permission-panel-transition-and-back-button.md
      20260419-2203-document-release-guide.md
      20260419-2205-bump-open-computer-use-to-0.1.12.md
      20260419-2219-refresh-official-overlay-arrow-findings.md
      20260419-2300-add-standalone-cursor-from-python-reconstruction.md
      20260420-1151-investigate-cursor-slider-binary-mapping.md
      20260420-1238-confirm-official-overlay-trigger-matrix.md
      20260420-1416-add-computer-use-cli-call-seq.md
      20260420-1558-fix-permission-relaunch-misdetection.md
      20260420-1608-unify-open-computer-use-app-identity.md
      20260420-1620-bump-open-computer-use-to-0.1.14.md
      20260420-1740-prepare-developer-id-signing-assets.md
      20260420-1745-bump-open-computer-use-to-0.1.13.md
      20260420-1758-enable-cursor-motion-notarization.md
      20260420-1806-remove-python-from-installers.md
      20260420-1808-bump-open-computer-use-to-0.1.17.md
      20260420-1810-bump-open-computer-use-to-0.1.19.md
      20260420-1815-bump-open-computer-use-to-0.1.15.md
      20260420-1818-fix-ci-signing-identity-fallback.md
      20260420-1825-clarify-youtube-demo-links-in-readme.md
      20260420-1828-fix-hardened-runtime-for-notarization.md
      20260420-1828-fix-release-codesign-identity-resolution.md
      20260420-1834-remove-rsync-from-plugin-installer.md
      20260420-1836-bump-open-computer-use-to-0.1.18.md
      20260420-1842-bump-open-computer-use-to-0.1.16.md
      20260420-1845-bump-open-computer-use-to-0.1.20.md
      20260420-1908-refresh-node24-compatible-actions.md
      20260420-2028-shrink-app-icon-safe-area.md
      20260420-2033-integrate-set-value-visual-cursor.md
      20260421-1113-fix-initial-visual-cursor-approach.md
      20260421-1210-bump-open-computer-use-to-0.1.21.md
      20260421-1211-align-cursor-initial-origin.md
      20260421-1611-bump-open-computer-use-to-0.1.22.md
      20260421-1624-document-official-computer-use-sender-auth.md
      20260421-1659-archive-official-computer-use-bundles.md
      20260421-2058-add-native-call-command.md
      20260421-2103-bump-open-computer-use-to-0.1.23.md
      20260421-2120-disable-click-global-pointer-default.md
      20260422-1015-bump-open-computer-use-to-0.1.24.md
      20260422-1050-align-set-value-settable-boundary.md
      20260422-1055-bump-open-computer-use-to-0.1.25.md
      20260422-1057-preserve-visual-cursor-idle-state.md
      20260422-1113-align-remaining-tool-defaults.md
      20260422-1115-bump-open-computer-use-to-0.1.26.md
      20260422-1124-add-textedit-overlay-sequence.md
      20260422-1150-bump-open-computer-use-to-0.1.27.md
      20260422-1156-align-runtime-cursor-speed.md
      20260422-1205-harden-npm-release-retry.md
      20260422-1234-bump-open-computer-use-to-0.1.28.md
      20260422-1246-add-windows-computer-use-runtime.md
      20260422-1338-fix-visual-cursor-coordinate-space.md
      20260422-1403-sequence-call-inter-operation-sleep.md
      20260422-1447-add-language-mirroring-rule-to-agents.md
      20260422-1452-sanitize-example-paths-and-sample-app-names.md
      20260422-1459-clarify-english-reply-rule.md
      20260422-1507-add-targeted-click-fallback.md
      20260422-1551-bump-open-computer-use-to-0.1.29.md
      20260422-1601-require-pull-latest-before-push.md
      20260422-1638-shorten-visual-cursor-idle-timeout.md
      20260422-1649-fix-visual-cursor-target-z-order.md
      20260422-1658-bump-v0-1-30-and-release-notes-rule.md
      20260422-1705-build-warning-cleanup.md
      20260422-1705-fix-targeted-mouse-coordinate-space.md
      20260422-1720-switch-visual-cursor-idle-to-rotate-shake.md
      20260422-1737-add-bgclick-free-research.md
      20260422-1759-bump-open-computer-use-to-0.1.32.md
      20260422-1816-add-gemini-opencode-mcp-installers.md
      20260422-1828-bump-open-computer-use-to-0.1.33.md
      20260422-1830-add-star-history-readme-chart.md
      20260422-1952-add-gemini-cli-demo-video.md
      20260422-2036-add-linux-computer-use-runtime.md
      20260423-1151-add-cross-platform-npm-packages.md
      20260423-1236-auto-linux-codex-mcp-session-env.md
      20260423-1417-organize-readme-demo-videos.md
    2026-05/
      20260503-1731-app-scoped-permission-agent.md
      20260506-1045-release-0.1.37.md
      20260506-1058-release-0.1.38.md
      20260507-1534-shrink-denylist-to-password-managers.md
      20260507-1553-bump-open-computer-use-to-0.1.39.md
      20260507-1638-feishu-electron-snapshot-stability.md
      20260507-1646-release-0.1.40.md
      20260507-1747-align-electron-snapshot-rendering.md
      20260507-1825-polish-accessibility-formatting.md
      20260507-1835-release-0.1.42.md
      20260507-1846-webarea-container-rendering.md
      20260507-1849-release-0.1.43.md
      20260507-1905-require-ax-window-for-snapshot.md
      20260507-1910-release-0.1.44.md
      20260507-1926-release-0.1.45.md
      20260507-1935-release-0.1.46.md
      20260507-1945-local-validation-before-release.md
      20260507-1958-recover-hidden-electron-window.md
      20260507-2004-align-tree-root-indentation.md
      20260507-2010-render-ax-placeholder.md
      20260507-2015-document-official-state-rendering.md
      20260507-2017-avoid-counter-text-merge.md
      20260507-2023-render-links-as-markdown.md
      20260507-2026-preserve-link-role-for-markdown.md
      20260507-2040-refresh-permission-onboarding.md
      20260507-2047-list-apps-frontmost.md
      20260507-2115-restart-stale-app-agent.md
      20260508-1022-align-feishu-state-wrappers.md
      20260508-1045-headless-smoke-fixture.md
      20260508-1203-release-0.1.47.md
      20260508-1508-bound-screenshot-result-size.md
      20260508-1518-release-0.1.48.md
      20260510-1129-readme-browser-use-tip.md
      20260511-1029-fix-open-panel-file-click.md
      20260511-1034-release-0.1.49.md
      20260512-1817-fix-macos-unicode-type-text.md
      20260512-1852-avoid-synthetic-row-side-action-clicks.md
      20260513-1413-release-0.1.50.md
      20260516-1117-open-computer-use-skill.md
      20260520-1641-fix-permission-onboarding-stale-panel.md
      20260520-1720-release-0.1.51.md
      20260526-1126-fix-cli-element-index.md
    2026-06/
      20260601-2002-agent-stress-validation.md
      20260603-2201-release-0.1.52.md
      20260605-1640-unify-snapshot-text-limit.md
      20260611-1608-release-0.1.53.md
      20260626-2206-add-ocu-cli-alias.md
      20260626-2216-release-0.1.54.md
      20260630-1635-unify-snapshot-tree-budget-defaults.md
    2026-07/
      20260708-1044-bump-v0.2.0.md
      20260710-1659-document-macos-14-requirement.md
      20260716-1548-preserve-anonymous-web-actions.md
      20260720-1736-bump-v0.2.1.md
      20260722-1718-add-configurable-click-method.md
      20260723-1655-preserve-sky-click-focus.md
      20260727-1425-bump-v0.3.0.md
      20260730-1431-preserve-generic-action-boundaries.md
      20260730-1608-bump-v0.3.1.md
      20260730-1637-enforce-english-github-release-notes.md
    2026-08/
      20260808-0409-fix-linux-atspi-interface-detection.md
    20260722-1905-add-sky-click.md
    template.md
  HISTORY_GUIDE.md
  PLANS_GUIDE.md
  PRODUCT_SENSE.md
  product-specs/
    index.md
  QUALITY_SCORE.md
  references/
    codex-computer-use-cli.md
    codex-computer-use-reverse-engineering/
      assets/
        extracted-2026-04-17/
          appicon-cursor-dark.png
          appicon-cursor.png
          hint-arrow.png
          menubar-cursor.png
          software-cursor-computeruse.png
          software-cursor-slimcore.png
        extracted-2026-04-19/
          official-software-cursor-pointer-raw-crop.png
          official-software-cursor-window-252-center-crop.png
          official-software-cursor-window-252.png
          official-software-cursor-window.png
        official-bundles/
          computer-use/
            1.0.750.zip
            1.0.755.zip
            README.md
            SHA256SUMS
        README.md
      background-click-free-tooling.md
      baseline-architecture.md
      internal-ipc-surface.md
      packaging-and-lifecycle-integration.md
      permission-onboarding.md
      README.md
      runtime-and-host-dependencies.md
      software-cursor-motion-model.md
      software-cursor-motion-reconstruction.md
      software-cursor-overlay.md
      software-cursor-slider-parameter-investigation.md
      state-rendering-1.0.770.md
      tool-call-samples-2026-04-17.md
    codex-local-runtime-logs.md
    codex-network-capture.md
    macos-skylight-background-click.md
    README.md
  releases/
    feature-release-notes.md
    github/
      TEMPLATE.md
      v0.2.0.md
      v0.2.1.md
      v0.3.0.md
      v0.3.1.md
    README.md
    RELEASE_GUIDE.md
  RELIABILITY.md
  REPO_COLLAB_GUIDE.md
  SECURITY.md
  SUPPLY_CHAIN_SECURITY.md
examples/
  textedit-overlay-seq.json
experiments/
  CursorMotion/
    README.md
    Sources/
      CursorMotion/
        CursorGlyphCalibration.swift
        CursorLabRootView.swift
        CursorMotionApp.swift
        CursorMotionModel.swift
        SynthesizedCursorGlyphView.swift
  StandaloneCursor/
    README.md
    Sources/
      StandaloneCursor/
        StandaloneCursorApp.swift
        StandaloneCursorRootView.swift
      StandaloneCursorSupport/
        StandaloneCursorModel.swift
    Tests/
      StandaloneCursorSupportTests/
        StandaloneCursorSupportTests.swift
LICENSE
Makefile
package.json
Package.swift
packages/
  OpenComputerUseKit/
    Sources/
      OpenComputerUseKit/
        AccessibilitySnapshot.swift
        AppDiscovery.swift
        ComputerUseService.swift
        ComputerUseToolDispatcher.swift
        CursorMotionModel.swift
        Errors.swift
        FixtureBridge.swift
        InputSimulation.swift
        KeyMapping.swift
        MCPServer.swift
        OpenComputerUseCLI.swift
        OpenComputerUseVersion.swift
        Permissions.swift
        SkyClickSimulation.swift
        SkyLightSPI.swift
        SoftwareCursorGlyphRenderer.swift
        SoftwareCursorOverlay.swift
        ToolDefinitions.swift
        ToolResult.swift
    Tests/
      OpenComputerUseKitTests/
        OpenComputerUseKitTests.swift
        SkyClickLiveTests.swift
plugins/
  open-computer-use/
... 66 more

FAQ

What is open-codex-computer-use?: Interested in Browser Use? Check out open-browser-use. open-computer-use is an open-source Computer Use service wrapped as MCP. Any AI agent or MCP client can use it to run Computer Use on macOS, Linux, and Windows.
How do I install open-codex-computer-use?: Run these in Claude Code: npx -y skills add iFurySt/open-codex-computer-use --agent claude-code. Then prompt normally.
Does open-codex-computer-use auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is open-codex-computer-use free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

open-codex-computer-use

Skills

MCP

Badges

README

open-computer-use

Demos

Codex App and Codex CLI

Gemini CLI

Linux

Quick Start

Skill

More

Cursor Motion

Star History

License

File tree

open-codex-computer-use

Skills

MCP

Badges

README

open-computer-use

Demos

Codex App and Codex CLI

Gemini CLI

Linux

Quick Start

Skill

More

Cursor Motion

Star History

License

File tree