👾 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
Mark frontmost app in list_apps
Leod62a6574665c
diff --git a/docs/histories/2026-05/20260507-2047-list-apps-frontmost.md b/docs/histories/2026-05/20260507-2047-list-apps-frontmost.mdnew file mode 100644index 0000000..b23cec1--- /dev/null+++ b/docs/histories/2026-05/20260507-2047-list-apps-frontmost.md@@ -0,0 +1,30 @@+# list_apps 标记前台应用++## 用户诉求++继续对齐官方 `computer-use` 工具返回,优先收敛 `list_apps` 与官方输出的可见差异。++## 主要改动++- `ListedAppDescriptor` 增加 `isFrontmost` 状态。+- `list_apps` 输出在前台 app 上渲染 `frontmost`,并放在 `running` 前面。+- 排序时优先把前台 app 放在运行中 app 列表顶部。+- 增加单测覆盖 `frontmost` 渲染顺序和排序优先级。++## 设计动机++官方 `computer-use` 的 `list_apps` 会明确标出当前前台应用,例如 `[frontmost, running, ...]`。这个标记能帮助 host 判断当前桌面上下文,也减少后续行动工具对目标窗口状态的猜测。++## 验证++- `swift test`+- `./scripts/build-open-computer-use-app.sh debug`+- `./scripts/run-tool-smoke-tests.sh`+- `./scripts/check-docs.sh`+- `git diff --check`+- Dev app CLI 直连确认第一行包含 `frontmost`++## 受影响文件++- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift`+- `packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift`diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swiftindex 940e820..0d2e164 100644--- a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift+++ b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift@@ -13,11 +13,15 @@ struct ListedAppDescriptor {let name: Stringlet bundleIdentifier: Stringlet isRunning: Bool+ let isFrontmost: Boollet lastUsed: Date?let uses: Int?var renderedLine: String {var markers: [String] = []+ if isFrontmost {+ markers.append("frontmost")+ }if isRunning {markers.append("running")}@@ -67,6 +71,7 @@ enum AppDiscovery {static func listCatalog() -> [ListedAppDescriptor] {let running = userFacingRunningApps()+ let frontmostBundleIdentifier = NSWorkspace.shared.frontmostApplication?.bundleIdentifier?.lowercased()let runningByBundle = running.reduce(into: [String: RunningAppDescriptor]()) { result, descriptor inguard let bundleIdentifier = listedBundleIdentifier(for: descriptor) else {return@@ -87,6 +92,7 @@ enum AppDiscovery {name: runningDescriptor?.name ?? record.name,bundleIdentifier: record.bundleIdentifier,isRunning: runningDescriptor != nil,+ isFrontmost: key == frontmostBundleIdentifier,lastUsed: record.lastUsed,uses: record.uses)@@ -103,6 +109,7 @@ enum AppDiscovery {name: descriptor.name,bundleIdentifier: bundleIdentifier,isRunning: true,+ isFrontmost: key == frontmostBundleIdentifier,lastUsed: existing?.lastUsed,uses: existing?.uses)@@ -212,7 +219,11 @@ enum AppDiscovery {return fixtureListBundleIdentifier}- private static func compareListedApps(_ lhs: ListedAppDescriptor, _ rhs: ListedAppDescriptor) -> Bool {+ static func compareListedApps(_ lhs: ListedAppDescriptor, _ rhs: ListedAppDescriptor) -> Bool {+ if lhs.isFrontmost != rhs.isFrontmost {+ return lhs.isFrontmost && !rhs.isFrontmost+ }+if lhs.isRunning != rhs.isRunning {return lhs.isRunning && !rhs.isRunning}diff --git a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swiftindex c4fb4be..209ccdf 100644--- a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift+++ b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift@@ -284,6 +284,41 @@ final class OpenComputerUseKitTests: XCTestCase {XCTAssertTrue(diagnostics.missingPermissions.isEmpty)}+ func testListedAppDescriptorRendersFrontmostBeforeRunning() {+ let descriptor = ListedAppDescriptor(+ name: "Sample",+ bundleIdentifier: "com.example.Sample",+ isRunning: true,+ isFrontmost: true,+ lastUsed: nil,+ uses: nil+ )++ XCTAssertEqual(descriptor.renderedLine, "Sample — com.example.Sample [frontmost, running]")+ }++ func testListedAppSortingPrefersFrontmostRunningApp() {+ let frontmost = ListedAppDescriptor(+ name: "Front",+ bundleIdentifier: "com.example.Front",+ isRunning: true,+ isFrontmost: true,+ lastUsed: nil,+ uses: nil+ )+ let frequent = ListedAppDescriptor(+ name: "Frequent",+ bundleIdentifier: "com.example.Frequent",+ isRunning: true,+ isFrontmost: false,+ lastUsed: Date(),+ uses: 999+ )++ XCTAssertTrue(AppDiscovery.compareListedApps(frontmost, frequent))+ XCTAssertFalse(AppDiscovery.compareListedApps(frequent, frontmost))+ }+func testPreferredPermissionAppBundleURLPrefersInstalledCopyOverTransientRunningCopy() {let installed = URL(fileURLWithPath: "/opt/homebrew/lib/node_modules/open-computer-use/dist/Open Computer Use.app")let running = URL(fileURLWithPath: "/Users/example/projects/open-codex-computer-use/dist/Open Computer Use.app")