👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
Swift accessibilityai-agentai-agentsclaude-codecodexcodex-computer-usecomputer-usecomputer-use-agentcross-platformcuadesktop-automationgemini-cligui-automationmacosmcpmodel-context-protocolopen-computer-useopen-computer-use-mcpopenai-codexopencode
fix: prefer running app bundle for macOS agent
usoon.xu038ce7fde1c7
diff --git a/apps/OpenComputerUseLinux/main.go b/apps/OpenComputerUseLinux/main.goindex b88f6ac..c916700 100644--- a/apps/OpenComputerUseLinux/main.go+++ b/apps/OpenComputerUseLinux/main.go@@ -19,7 +19,7 @@ import ("time")-var version = "0.1.37"+var version = "0.1.38"//go:embed runtime.pyvar linuxRuntimeScript stringdiff --git a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swiftindex 27c4e47..58fbfc6 100644--- a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift+++ b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift@@ -35,7 +35,7 @@ final class MCPClient {_ = try request(method: "initialize", params: ["clientInfo": ["name": "OpenComputerUseSmokeSuite",- "version": "0.1.37",+ "version": "0.1.38",],"capabilities": [:],"protocolVersion": "2025-03-26",diff --git a/apps/OpenComputerUseWindows/main.go b/apps/OpenComputerUseWindows/main.goindex f561fc8..3ea0e6b 100644--- a/apps/OpenComputerUseWindows/main.go+++ b/apps/OpenComputerUseWindows/main.go@@ -16,7 +16,7 @@ import ("time")-var version = "0.1.37"+var version = "0.1.38"//go:embed runtime.ps1var windowsRuntimeScript stringdiff --git a/docs/histories/2026-05/20260506-1058-release-0.1.38.md b/docs/histories/2026-05/20260506-1058-release-0.1.38.mdnew file mode 100644index 0000000..f5d31cf--- /dev/null+++ b/docs/histories/2026-05/20260506-1058-release-0.1.38.md@@ -0,0 +1,34 @@+## [2026-05-06 10:58] | Task: 发布 0.1.38 hotfix++### Execution Context+* **Agent ID**: `Codex`+* **Base Model**: `GPT-5`+* **Runtime**: `local macOS workspace`++### User Query+> `npm install -g open-computer-use` 后 `open-computer-use doctor` 仍然超时。++### Changes Overview+**Scope:** macOS permission app selection, release version sources, release notes++**Key Actions:**+- **[App Selection Hotfix]**: 当当前进程来自合法 `Open Computer Use.app` bundle 时,`currentAppBundleURL()` 优先返回正在执行的 bundle,避免 LaunchServices / Spotlight 返回仓库中残留的旧 staging app。+- **[Regression Test]**: 补充纯函数测试,锁定“运行中的 release bundle 可以覆盖 stale installed copy”的选择规则。+- **[Version Bump]**: 将插件 manifest、Swift/Go 运行时版本、smoke/test 初始化版本和 CLI helper 示例统一提升到 `0.1.38`。+- **[Release Notes]**: 记录 npm 安装后 `doctor` 启动错旧副本导致超时的修复。++### Design Intent (Why)+`0.1.37` 已把 macOS automation 转发给 app-agent,但 app 发现仍优先相信 `NSWorkspace.urlForApplication(withBundleIdentifier:)`。在开发机器上,LaunchServices 可能返回仓库里旧的 `dist/npm/.../Open Computer Use.app`,导致新 npm CLI 去启动旧 app-agent 并超时。当前进程所在的 `.app` 是用户实际执行的 npm 产物,应该优先作为 agent 启动目标。++### Files Modified+- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift`+- `packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift`+- `plugins/open-computer-use/.codex-plugin/plugin.json`+- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift`+- `apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift`+- `apps/OpenComputerUseLinux/main.go`+- `apps/OpenComputerUseWindows/main.go`+- `scripts/computer-use-cli/main.go`+- `scripts/computer-use-cli/README.md`+- `docs/releases/feature-release-notes.md`+- `docs/histories/2026-05/20260506-1058-release-0.1.38.md`diff --git a/docs/releases/feature-release-notes.md b/docs/releases/feature-release-notes.mdindex 25d4844..e678428 100644--- a/docs/releases/feature-release-notes.md+++ b/docs/releases/feature-release-notes.md@@ -4,6 +4,7 @@| 日期 | 功能域 | 用户价值 | 变更摘要 || --- | --- | --- | --- |+| 2026-05-06 | npm 安装后的 app-agent 启动 | `npm install -g open-computer-use` 后,`open-computer-use doctor` 不会再因为本机残留旧 staging `.app` 而启动错副本并超时。 | 发布 `0.1.38`,当当前进程已经来自合法 `Open Computer Use.app` bundle 时,代理启动优先复用正在执行的 bundle,再回退到 LaunchServices / 标准安装目录发现的其它副本。 || 2026-05-06 | macOS 权限身份 | macOS 用户重新安装新版 npm 包后,只需要授权 `Open Computer Use.app`,不再要求给 iTerm / Terminal 单独授予 Accessibility 或 Screen Recording。 | 发布 `0.1.37`,将 `mcp`、`doctor`、`call`、`snapshot` 和 `list-apps` 通过 LaunchServices 启动的 app-agent 执行,让真实 AX / ScreenCaptureKit 调用落在 `.app` 权限主体上,并同步更新权限文案和版本源。 |## 2026-04diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swiftindex d0d9f5e..022a1bf 100644--- a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift+++ b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift@@ -1,6 +1,6 @@import Foundation-public let openComputerUseVersion = "0.1.37"+public let openComputerUseVersion = "0.1.38"public func resolvedOpenComputerUseVersion(bundle: Bundle = .main) -> String {if let version = bundle.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String,diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swiftindex f8c3cc4..e20a61c 100644--- a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift+++ b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift@@ -129,7 +129,7 @@ public enum PermissionSupport {preferredInstalledBundleURL: preferredInstalledAppBundleURL(),runningBundleURL: runningBundleURL,fallbackDevelopmentBundleURL: fallbackDevelopmentAppBundleURL(),- preferRunningBundle: isDevelopmentAppBundle(runningBundleURL)+ preferRunningBundle: runningBundleURL != nil)}diff --git a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swiftindex 30a0e9d..bc81010 100644--- a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift+++ b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift@@ -313,6 +313,20 @@ final class OpenComputerUseKitTests: XCTestCase {XCTAssertEqual(resolved, running)}+ func testPreferredPermissionAppBundleURLCanPreferRunningReleaseCopyOverStaleInstalledCopy() {+ let staleInstalled = URL(fileURLWithPath: "/Users/example/projects/open-codex-computer-use/dist/npm/open-computer-use/dist/Open Computer Use.app")+ let running = URL(fileURLWithPath: "/opt/homebrew/lib/node_modules/open-computer-use/dist/Open Computer Use.app")++ let resolved = PermissionSupport.preferredPermissionAppBundleURL(+ preferredInstalledBundleURL: staleInstalled,+ runningBundleURL: running,+ fallbackDevelopmentBundleURL: nil,+ preferRunningBundle: true+ )++ XCTAssertEqual(resolved, running)+ }+func testPreferredInstalledAppBundleURLUsesFirstDiscoveredInstalledCopy() {let applications = URL(fileURLWithPath: "/Applications/Open Computer Use.app")let npm = URL(fileURLWithPath: "/opt/homebrew/lib/node_modules/open-computer-use/dist/Open Computer Use.app")@@ -387,7 +401,7 @@ final class OpenComputerUseKitTests: XCTestCase {func testInitializeResponseContainsToolsCapability() throws {let server = StdioMCPServer(service: ComputerUseService())- let response = server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.37"},"capabilities":{}}}"#)+ let response = server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.38"},"capabilities":{}}}"#)XCTAssertNotNil(response)XCTAssertTrue(response!.contains(#""name":"open-computer-use""#))XCTAssertTrue(response!.contains(#""tools":{"listChanged":false}"#))@@ -396,7 +410,7 @@ final class OpenComputerUseKitTests: XCTestCase {func testInitializeResponseContainsComputerUseInstructions() throws {let server = StdioMCPServer(service: ComputerUseService())let response = try XCTUnwrap(- server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.37"},"capabilities":{}}}"#)+ server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.38"},"capabilities":{}}}"#))let data = try XCTUnwrap(response.data(using: .utf8))let json = try XCTUnwrap(JSONSerialization.jsonObject(with: data) as? [String: Any])diff --git a/plugins/open-computer-use/.codex-plugin/plugin.json b/plugins/open-computer-use/.codex-plugin/plugin.jsonindex a53ddd5..0909932 100644--- a/plugins/open-computer-use/.codex-plugin/plugin.json+++ b/plugins/open-computer-use/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "open-computer-use",- "version": "0.1.37",+ "version": "0.1.38","description": "Open-source cross-platform Computer Use MCP server packaged as a Codex plugin.","author": {"name": "Leo",diff --git a/scripts/computer-use-cli/README.md b/scripts/computer-use-cli/README.mdindex 4aed16a..847036a 100644--- a/scripts/computer-use-cli/README.md+++ b/scripts/computer-use-cli/README.md@@ -131,7 +131,7 @@ Example working invocation against `open-computer-use`:```bashgo run . list-tools \--transport direct \- --server-bin ~/.codex/plugins/cache/open-computer-use-local/open-computer-use/0.1.37/scripts/launch-open-computer-use.sh+ --server-bin ~/.codex/plugins/cache/open-computer-use-local/open-computer-use/0.1.38/scripts/launch-open-computer-use.sh```Example working comparison flow against a local repo build:diff --git a/scripts/computer-use-cli/main.go b/scripts/computer-use-cli/main.goindex 481b16c..854463d 100644--- a/scripts/computer-use-cli/main.go+++ b/scripts/computer-use-cli/main.go@@ -21,7 +21,7 @@ import (const (cliName = "computer-use-cli"- cliVersion = "0.1.37"+ cliVersion = "0.1.38"defaultTimeout = 60 * time.SecondpluginRootEnvVar = "COMPUTER_USE_PLUGIN_ROOT"pluginVersionEnvVar = "COMPUTER_USE_PLUGIN_VERSION"