Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

fix: prefer running app bundle for macOS agent

usoon.xu038ce7fde1c7
diff --git a/apps/OpenComputerUseLinux/main.go b/apps/OpenComputerUseLinux/main.go
index 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.py
var linuxRuntimeScript string
diff --git a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
index 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.go
index 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.ps1
var windowsRuntimeScript string
diff --git a/docs/histories/2026-05/20260506-1058-release-0.1.38.md b/docs/histories/2026-05/20260506-1058-release-0.1.38.md
new file mode 100644
index 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.md
index 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-04
diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift
index 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.swift
index 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.swift
index 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.json
index 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.md
index 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`:
```bash
go 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.go
index 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.Second
pluginRootEnvVar = "COMPUTER_USE_PLUGIN_ROOT"
pluginVersionEnvVar = "COMPUTER_USE_PLUGIN_VERSION"