Skip to content

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

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.md
new file mode 100644
index 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.swift
index 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: String
let bundleIdentifier: String
let isRunning: Bool
+ let isFrontmost: Bool
let 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 in
guard 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.swift
index 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")