Skip to content

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

Hide Dock icon for onboarding app

Leo06e196360ddb
diff --git a/README.md b/README.md
index 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.swift
index cea5b9e..d6273a9 100644
--- a/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift
+++ b/apps/OpenCodexComputerUse/Sources/OpenCodexComputerUse/PermissionOnboardingApp.swift
@@ -6,7 +6,7 @@ import OpenCodexComputerUseKit
enum 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.md
index 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.md
index 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.md
new file mode 100644
index 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.sh
index 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>