👾 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
Hide Dock icon for onboarding app
Leo06e196360ddb
diff --git a/README.md b/README.mdindex b848df2..dd0168b 100644--- a/README.md+++ b/README.md@@ -7,7 +7,7 @@当前版本聚焦两件事:- 通过 `stdio` MCP 暴露 9 个和官方 `computer-use` 同名的 tools。-- 在仓库内自带一个 GUI fixture app、smoke suite 和 app 模式权限引导,保证这 9 个 tools 有稳定可回归的本地验证路径。+- 在仓库内自带一个 GUI fixture app、smoke suite 和无 Dock 图标的 app 模式权限引导,保证这 9 个 tools 有稳定可回归的本地验证路径。当前实现的 9 个 tools:@@ -63,12 +63,12 @@ swift test.build/debug/OpenCodexComputerUse snapshot Finder```-如果直接运行 `OpenCodexComputerUse` 而不带子命令,默认会进入 app 模式并显示权限 onboarding 窗口。+如果直接运行 `OpenCodexComputerUse` 而不带子命令,默认会进入 app 模式并显示权限 onboarding 窗口;该窗口以 agent-style app 方式运行,不会在 Dock 常驻显示图标。## 工程结构- `apps/OpenCodexComputerUse`- `stdio` MCP server、本地诊断入口和默认 app 模式权限引导。+ `stdio` MCP server、本地诊断入口和默认 app 模式权限引导;默认 bundle 以 agent-style 运行,避免在执行过程中额外暴露 Dock 图标。- `packages/OpenCodexComputerUseKit`MCP transport、tool registry、app discovery、snapshot、输入模拟和 fixture bridge。- `apps/OpenCodexComputerUseFixture`diff --git a/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift b/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swiftindex cea5b9e..d6273a9 100644--- a/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift+++ b/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift@@ -6,7 +6,7 @@ import OpenCodexComputerUseKitenum PermissionOnboardingApp {static func launch() {let application = NSApplication.shared- application.setActivationPolicy(.regular)+ application.setActivationPolicy(.accessory)application.applicationIconImage = Branding.makeAppIconImage(size: 256)let delegate = PermissionOnboardingAppDelegate()diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.mdindex 22ea8b2..75f8545 100644--- a/docs/ARCHITECTURE.md+++ b/docs/ARCHITECTURE.md@@ -5,7 +5,7 @@## 当前目录结构- `apps/OpenCodexComputerUse`- 主入口,负责 `mcp`、`doctor`、`list-apps`、`snapshot` 等 CLI 命令;不带参数启动时默认进入 app 模式权限引导窗口。+ 主入口,负责 `mcp`、`doctor`、`list-apps`、`snapshot` 等 CLI 命令;不带参数启动时默认进入无 Dock 图标的 app 模式权限引导窗口。- `apps/OpenCodexComputerUseFixture`本地 GUI fixture app,用来承载低风险、可预测的点击/输入/滚动/拖拽验证路径。- `apps/OpenCodexComputerUseSmokeSuite`@@ -27,6 +27,7 @@### 1. App Mode 层- `OpenCodexComputerUse` 默认 app 模式会拉起 `PermissionOnboardingApp`。+- app bundle 以 `LSUIElement` agent-style 形态运行,默认不在 Dock 暴露常驻图标,但仍可按需显示权限窗口。- 主窗口负责渲染 `Accessibility` / `Screen & System Audio Recording` 两类权限卡片、`Allow` / `Done` 状态和 relaunch 后的状态收敛。- 辅助 drag panel 会跳转到对应的 `System Settings` 页面,并提供 app bundle 拖拽 tile。- 权限状态优先基于 TCC 持久授权记录判断,避免 CLI 子进程与 GUI app 对授权状态看到不一致的结果。diff --git a/docs/exec-plans/active/20260417-permission-onboarding-app.md b/docs/exec-plans/active/20260417-permission-onboarding-app.mdindex c6b9431..e82aeaf 100644--- a/docs/exec-plans/active/20260417-permission-onboarding-app.md+++ b/docs/exec-plans/active/20260417-permission-onboarding-app.md@@ -74,6 +74,7 @@- 2026-04-17:权限 onboarding 直接做进 `OpenCodexComputerUse` 主 target,而不是另起一个完全独立的 helper app。这样 `mcp` CLI 和 app bundle 可复用同一个可执行文件与 bundle 身份。- 2026-04-17:权限状态判定加入对 TCC 持久授权记录的读取,避免 dev 环境里 CLI 子进程与 GUI app 对同一 bundle 权限状态看到不一致的结果。- 2026-04-17:drag panel 当前收敛到“只在 `System Settings` 前台时显示,并锚到 `Add` / `Remove` 控制区”的近似方案;更接近官方嵌入式 choreography 的视觉行为后续再补。+- 2026-04-17:app 模式改成 `LSUIElement` + `.accessory` agent-style 运行,保证权限窗口可见,但执行过程中不再额外在 Dock 暴露前台 app 图标。## 当前结论diff --git a/docs/histories/2026-04/20260417-1504-hide-dock-icon-for-onboarding-app.md b/docs/histories/2026-04/20260417-1504-hide-dock-icon-for-onboarding-app.mdnew file mode 100644index 0000000..409ab4b--- /dev/null+++ b/docs/histories/2026-04/20260417-1504-hide-dock-icon-for-onboarding-app.md@@ -0,0 +1,27 @@+## [2026-04-17 15:04] | Task: 收敛 app 模式的 Dock 暴露++### 🤖 Execution Context+* **Agent ID**: `Codex`+* **Base Model**: `GPT-5`+* **Runtime**: `Codex CLI / Swift 6.2.4 / macOS`++### 📥 User Query+> 执行过程中 Dock 里会出现 `OpenCodexComputerUse`,看起来很奇怪;除了权限弹窗页面以外,其余执行都应该静默在后台。++### 🛠 Changes Overview+**Scope:** `apps/OpenCodexComputerUse`, `scripts/`, `docs/`++**Key Actions:**+- **[收敛 app activation policy]**: 把 `PermissionOnboardingApp` 从 `.regular` 改成 `.accessory`,保留权限窗口可见性,但不再把 app 作为普通前台应用暴露到 Dock。+- **[修正 bundle 元数据]**: 在打包脚本生成的 `Info.plist` 中加入 `LSUIElement = true`,让从 `.app` bundle 启动的进程也保持 agent-style 行为。+- **[同步文档]**: 更新 README、架构文档和权限 onboarding execution plan,明确“无 Dock 图标、仅按需显示权限窗口”的产品边界。++### 🧠 Design Intent (Why)+这次改动的目标不是隐藏权限引导本身,而是让 `OpenCodexComputerUse` 的运行形态更接近后台 automation service。权限 onboarding 仍然需要显式窗口,但普通执行和 bundle 常驻不应该因为被配置成前台 `NSApplication` 而在 Dock 里露出额外图标。++### 📁 Files Modified+- `apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift`+- `scripts/build-open-codex-app.sh`+- `README.md`+- `docs/ARCHITECTURE.md`+- `docs/exec-plans/active/20260417-permission-onboarding-app.md`diff --git a/scripts/build-open-codex-app.sh b/scripts/build-open-codex-app.shindex 5179a35..1e39fe7 100755--- a/scripts/build-open-codex-app.sh+++ b/scripts/build-open-codex-app.sh@@ -47,6 +47,8 @@ cat > "${contents_dir}/Info.plist" <<'PLIST'<string>1</string><key>LSMinimumSystemVersion</key><string>14.0</string>+ <key>LSUIElement</key>+ <true/><key>NSPrincipalClass</key><string>NSApplication</string></dict>