Skip to content

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

Release 0.1.10

ifuryst2b3c9569d1b9
diff --git a/apps/OpenComputerUse/Sources/OpenComputerUse/OpenComputerUseMain.swift b/apps/OpenComputerUse/Sources/OpenComputerUse/OpenComputerUseMain.swift
index 4bccb48..f66d167 100644
--- a/apps/OpenComputerUse/Sources/OpenComputerUse/OpenComputerUseMain.swift
+++ b/apps/OpenComputerUse/Sources/OpenComputerUse/OpenComputerUseMain.swift
@@ -46,7 +46,9 @@ enum OpenComputerUseMain {
case .version:
print(resolvedOpenComputerUseVersion())
case .launchOnboarding:
- PermissionOnboardingApp.launch()
+ if !PermissionDiagnostics.current().allGranted {
+ PermissionOnboardingApp.launch()
+ }
}
}
diff --git a/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift b/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
index f232be3..e3ffb14 100644
--- a/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
+++ b/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
@@ -5,6 +5,10 @@ import OpenComputerUseKit
@MainActor
enum PermissionOnboardingApp {
static func launch() {
+ guard !PermissionDiagnostics.current().allGranted else {
+ return
+ }
+
let application = NSApplication.shared
application.setActivationPolicy(.accessory)
application.applicationIconImage = Branding.makeAppIconImage(size: 256)
@@ -82,12 +86,19 @@ extension PermissionWindowController: PermissionContentControllerDelegate {
func permissionContentControllerDidResolveGuidance(_ controller: PermissionContentController) {
accessoryPanelController.hide()
}
+
+ func permissionContentControllerDidCompleteAllPermissions(_ controller: PermissionContentController) {
+ accessoryPanelController.hide()
+ close()
+ NSApp.terminate(nil)
+ }
}
@MainActor
protocol PermissionContentControllerDelegate: AnyObject {
func permissionContentController(_ controller: PermissionContentController, didRequestPermission permission: SystemPermissionKind)
func permissionContentControllerDidResolveGuidance(_ controller: PermissionContentController)
+ func permissionContentControllerDidCompleteAllPermissions(_ controller: PermissionContentController)
}
private enum PermissionOnboardingLayout {
@@ -123,6 +134,7 @@ final class PermissionContentController: NSViewController {
private var activeGuidance: SystemPermissionKind?
private var refreshTimer: Timer?
private var diagnostics = PermissionDiagnostics.current()
+ private var hasReportedCompletion = false
override func loadView() {
view = NSView()
@@ -152,6 +164,7 @@ final class PermissionContentController: NSViewController {
private func refreshState() {
let updated = PermissionDiagnostics.current()
let previousGuidance = activeGuidance
+ let wasAllGranted = diagnostics.allGranted
diagnostics = updated
if let activeGuidance, updated.isGranted(activeGuidance) {
@@ -163,6 +176,11 @@ final class PermissionContentController: NSViewController {
if previousGuidance != nil, activeGuidance == nil {
delegate?.permissionContentControllerDidResolveGuidance(self)
}
+
+ if updated.allGranted, !wasAllGranted, !hasReportedCompletion {
+ hasReportedCompletion = true
+ delegate?.permissionContentControllerDidCompleteAllPermissions(self)
+ }
}
private func configureUI() {
@@ -407,19 +425,17 @@ final class GuidancePlaceholderView: NSView {
@MainActor
final class PermissionAccessoryPanelController {
- private let trackingInterval: TimeInterval = 0.12
private var panel: NSPanel?
private var currentPermission: SystemPermissionKind?
- private var trackingTimer: Timer?
private var workspaceObserver: NSObjectProtocol?
private var globalDragMonitor: Any?
private var localDragMonitor: Any?
+ private var orderedWindowNumber: Int?
private enum Layout {
static let screenHorizontalInset: CGFloat = 16
static let screenBottomInset: CGFloat = 12
static let windowBottomOverlap: CGFloat = 6
- static let controlsBottomGap: CGFloat = 12
static let contentLeadingInset: CGFloat = 26
static let contentTrailingInset: CGFloat = 28
static let sidebarWidthRatio: CGFloat = 0.29
@@ -430,7 +446,11 @@ final class PermissionAccessoryPanelController {
private struct PanelAnchor {
let windowBounds: CGRect
let contentTrackRect: CGRect
- let accessoryAnchorRect: CGRect?
+ }
+
+ private struct SystemSettingsWindowContext {
+ let bounds: CGRect
+ let windowNumber: Int
}
func show(for permission: SystemPermissionKind) {
@@ -444,17 +464,15 @@ final class PermissionAccessoryPanelController {
}
installObserversIfNeeded()
- startTracking()
position(panel: panel)
updatePanelVisibility()
}
func hide() {
- trackingTimer?.invalidate()
- trackingTimer = nil
removeObservers()
panel?.orderOut(nil)
currentPermission = nil
+ orderedWindowNumber = nil
}
private func makePanel() -> NSPanel {
@@ -464,7 +482,7 @@ final class PermissionAccessoryPanelController {
backing: .buffered,
defer: false
)
- panel.level = .normal
+ panel.level = .floating
panel.backgroundColor = .clear
panel.isOpaque = false
panel.hasShadow = true
@@ -522,17 +540,6 @@ final class PermissionAccessoryPanelController {
}
}
- private func startTracking() {
- trackingTimer?.invalidate()
- trackingTimer = Timer.scheduledTimer(withTimeInterval: trackingInterval, repeats: true) { [weak self] _ in
- Task { @MainActor [weak self] in
- self?.updatePanelVisibility()
- self?.refreshPosition()
- }
- }
- trackingTimer?.tolerance = 0.05
- }
-
private func refreshPosition() {
guard let panel, currentPermission != nil, panel.isVisible else {
return
@@ -546,18 +553,26 @@ final class PermissionAccessoryPanelController {
return
}
- guard isSystemSettingsFrontmost else {
+ guard isSystemSettingsFrontmost, let windowContext = systemSettingsWindowContext() else {
panel.orderOut(nil)
return
}
- if !panel.isVisible {
- panel.orderFront(nil)
+ if orderedWindowNumber != windowContext.windowNumber || panel.isVisible == false {
+ panel.order(.above, relativeTo: windowContext.windowNumber)
+ orderedWindowNumber = windowContext.windowNumber
}
}
private func position(panel: NSPanel) {
- guard let origin = preferredPanelOrigin(for: panel.frame.size) else {
+ guard let windowContext = systemSettingsWindowContext() else {
+ return
+ }
+
+ guard let origin = preferredPanelOrigin(
+ for: panel.frame.size,
+ windowBounds: windowContext.bounds
+ ) else {
return
}
@@ -566,8 +581,11 @@ final class PermissionAccessoryPanelController {
}
}
- private func preferredPanelOrigin(for panelSize: CGSize) -> CGPoint? {
- guard let anchor = preferredPanelAnchor() else {
+ private func preferredPanelOrigin(
+ for panelSize: CGSize,
+ windowBounds: CGRect
+ ) -> CGPoint? {
+ guard let anchor = preferredPanelAnchor(windowBounds: windowBounds) else {
return nil
}
@@ -579,12 +597,7 @@ final class PermissionAccessoryPanelController {
lower: visibleFrame.minX + Layout.screenHorizontalInset,
upper: visibleFrame.maxX - panelSize.width - Layout.screenHorizontalInset
)
- let anchorMinY = anchor.accessoryAnchorRect?.minY ?? referenceRect.minY
- let desiredY = if anchor.accessoryAnchorRect != nil {
- anchorMinY - panelSize.height - Layout.controlsBottomGap
- } else {
- anchorMinY - panelSize.height + Layout.windowBottomOverlap
- }
+ let desiredY = referenceRect.minY - panelSize.height + Layout.windowBottomOverlap
let y = max(
visibleFrame.minY + Layout.screenBottomInset,
desiredY
@@ -592,16 +605,12 @@ final class PermissionAccessoryPanelController {
return CGPoint(x: x, y: y)
}
- private func preferredPanelAnchor() -> PanelAnchor? {
- let referenceRect = systemSettingsWindowBounds() ?? NSScreen.main?.visibleFrame
- guard let referenceRect else {
- return nil
- }
+ private func preferredPanelAnchor(windowBounds: CGRect) -> PanelAnchor? {
+ let referenceRect = windowBounds
return PanelAnchor(
windowBounds: referenceRect,
- contentTrackRect: systemSettingsContentTrackRect(in: referenceRect),
- accessoryAnchorRect: systemSettingsControlsRowRect(in: referenceRect)
+ contentTrackRect: systemSettingsContentTrackRect(in: referenceRect)
)
}
@@ -630,6 +639,23 @@ final class PermissionAccessoryPanelController {
NSScreen.screens.first(where: { $0.visibleFrame.intersects(rect) })?.visibleFrame
}
+ private func appKitRect(fromCGWindowBounds bounds: CGRect) -> CGRect {
+ guard let screen = NSScreen.screens.first(where: { screen in
+ let screenBoundsInQuartz = CGRect(
+ x: screen.frame.minX,
+ y: screen.frame.minY,
+ width: screen.frame.width,
+ height: screen.frame.height
+ )
+ return screenBoundsInQuartz.intersects(bounds)
+ }) ?? NSScreen.main else {
+ return bounds
+ }
+
+ let convertedY = screen.frame.maxY - bounds.maxY
+ return CGRect(x: bounds.minX, y: convertedY, width: bounds.width, height: bounds.height)
+ }
+
private var isSystemSettingsFrontmost: Bool {
NSWorkspace.shared.frontmostApplication?.bundleIdentifier == "com.apple.systempreferences"
}
@@ -642,7 +668,7 @@ final class PermissionAccessoryPanelController {
return min(max(value, lower), upper)
}
- private func systemSettingsWindowBounds() -> CGRect? {
+ private func systemSettingsWindowContext() -> SystemSettingsWindowContext? {
guard let runningApp = NSWorkspace.shared.runningApplications.first(where: { $0.bundleIdentifier == "com.apple.systempreferences" }) else {
return nil
}
@@ -651,190 +677,26 @@ final class PermissionAccessoryPanelController {
return nil
}
- let windows = windowInfoList.compactMap { info -> (CGRect, Int)? in
+ let windows = windowInfoList.compactMap { info -> (SystemSettingsWindowContext, Int)? in
guard
let ownerPID = info[kCGWindowOwnerPID as String] as? pid_t,
ownerPID == runningApp.processIdentifier,
let layer = info[kCGWindowLayer as String] as? Int,
layer == 0,
+ let windowNumber = info[kCGWindowNumber as String] as? Int,
let boundsDictionary = info[kCGWindowBounds as String] as? NSDictionary,
let bounds = CGRect(dictionaryRepresentation: boundsDictionary)
else {
return nil
}
- return (bounds, Int(bounds.width * bounds.height))
+ let appKitBounds = appKitRect(fromCGWindowBounds: bounds)
+ return (SystemSettingsWindowContext(bounds: appKitBounds, windowNumber: windowNumber), Int(appKitBounds.width * appKitBounds.height))
}
return windows.sorted(by: { $0.1 > $1.1 }).first?.0
}
- private func systemSettingsControlsRowRect(in windowBounds: CGRect) -> CGRect? {
- guard let runningApp = NSWorkspace.shared.runningApplications.first(where: { $0.bundleIdentifier == "com.apple.systempreferences" }) else {
- return nil
- }
-
- let appElement = AXUIElementCreateApplication(runningApp.processIdentifier)
- guard let windowElement = preferredAXWindow(for: appElement) else {
- return nil
- }
-
- let candidates = collectControlsRowCandidates(in: windowElement, windowBounds: windowBounds)
- guard !candidates.isEmpty else {
- return nil
- }
-
- switch currentPermission {
- case .screenRecording:
- return candidates.max(by: { $0.midY < $1.midY })
- default:
- return candidates.min(by: { $0.minY < $1.minY })
- }
- }
-
- private func preferredAXWindow(for appElement: AXUIElement) -> AXUIElement? {
- copyAXElement(appElement, attribute: kAXFocusedWindowAttribute)
- ?? copyAXElement(appElement, attribute: kAXMainWindowAttribute)
- ?? copyAXArray(appElement, attribute: kAXWindowsAttribute)?.first
- }
-
- private func collectControlsRowCandidates(in root: AXUIElement, windowBounds: CGRect) -> [CGRect] {
- let elements = flattenedAXDescendants(of: root, maxDepth: 8, maxNodes: 400)
- let symbolButtons = elements.compactMap { symbolButtonDescriptor(for: $0) }
- guard !symbolButtons.isEmpty else {
- return []
- }
-
- let contentTrackRect = systemSettingsContentTrackRect(in: windowBounds)
- let controlButtons = symbolButtons.filter { descriptor in
- let frame = descriptor.frame
- return frame.intersects(windowBounds) &&
- frame.midX >= contentTrackRect.minX - 24 &&
- frame.midX <= contentTrackRect.maxX &&
- frame.width <= 40 &&
- frame.height <= 40
- }
-
- let plusButtons = controlButtons.filter { $0.symbol == "+" }
- let minusButtons = controlButtons.filter { $0.symbol == "-" }
-
- return plusButtons.compactMap { plusButton in
- let matchingMinusButtons = minusButtons.filter { minusButton in
- abs(minusButton.frame.midY - plusButton.frame.midY) <= 10 &&
- minusButton.frame.minX >= plusButton.frame.maxX - 4 &&
- minusButton.frame.minX - plusButton.frame.maxX <= 28
- }
-
- guard let minusButton = matchingMinusButtons.min(by: {
- abs($0.frame.midY - plusButton.frame.midY) < abs($1.frame.midY - plusButton.frame.midY)
- }) else {
- return nil
- }
-
- return plusButton.frame.union(minusButton.frame)
- }
- }
-
- private func flattenedAXDescendants(of root: AXUIElement, maxDepth: Int, maxNodes: Int) -> [AXUIElement] {
- var results: [AXUIElement] = []
- var queue: [(AXUIElement, Int)] = [(root, 0)]
-
- while !queue.isEmpty, results.count < maxNodes {
- let (element, depth) = queue.removeFirst()
- results.append(element)
-
- guard depth < maxDepth else {
- continue
- }
-
- for child in copyAXArray(element, attribute: kAXChildrenAttribute) ?? [] {
- queue.append((child, depth + 1))
- }
- }
-
- return results
- }
-
- private func symbolButtonDescriptor(for element: AXUIElement) -> (symbol: String, frame: CGRect)? {
- guard stringAXAttribute(element, attribute: kAXRoleAttribute) == kAXButtonRole as String else {
- return nil
- }
-
- guard let frame = frame(of: element) else {
- return nil
- }
-
- let rawLabels = [
- stringAXAttribute(element, attribute: kAXTitleAttribute),
- stringAXAttribute(element, attribute: kAXDescriptionAttribute),
- stringAXAttribute(element, attribute: kAXValueAttribute)
- ]
- .compactMap { $0?.trimmingCharacters(in: .whitespacesAndNewlines) }
- .filter { !$0.isEmpty }
-
- guard let symbol = rawLabels.first(where: { $0 == "+" || $0 == "-" }) else {
- return nil
- }
-
- return (symbol, frame)
- }
-
- private func frame(of element: AXUIElement) -> CGRect? {
- var positionValue: CFTypeRef?
- var sizeValue: CFTypeRef?
- guard
- AXUIElementCopyAttributeValue(element, kAXPositionAttribute as CFString, &positionValue) == .success,
- AXUIElementCopyAttributeValue(element, kAXSizeAttribute as CFString, &sizeValue) == .success,
- let positionValue,
- let sizeValue
- else {
- return nil
- }
-
- let positionAXValue = positionValue as! AXValue
- let sizeAXValue = sizeValue as! AXValue
- var position = CGPoint.zero
- var size = CGSize.zero
- guard
- AXValueGetValue(positionAXValue, .cgPoint, &position),
- AXValueGetValue(sizeAXValue, .cgSize, &size)
- else {
- return nil
- }
-
- return CGRect(origin: position, size: size)
- }
-
- private func copyAXElement(_ element: AXUIElement, attribute: String) -> AXUIElement? {
- var value: CFTypeRef?
- guard
- AXUIElementCopyAttributeValue(element, attribute as CFString, &value) == .success,
- let value,
- CFGetTypeID(value) == AXUIElementGetTypeID()
- else {
- return nil
- }
-
- return (value as! AXUIElement)
- }
-
- private func copyAXArray(_ element: AXUIElement, attribute: String) -> [AXUIElement]? {
- var value: CFTypeRef?
- guard AXUIElementCopyAttributeValue(element, attribute as CFString, &value) == .success else {
- return nil
- }
-
- return value as? [AXUIElement]
- }
-
- private func stringAXAttribute(_ element: AXUIElement, attribute: String) -> String? {
- var value: CFTypeRef?
- guard AXUIElementCopyAttributeValue(element, attribute as CFString, &value) == .success else {
- return nil
- }
-
- return value as? String
- }
}
@MainActor
diff --git a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
index 7459a0a..cdac287 100644
--- a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
+++ b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
@@ -34,7 +34,7 @@ final class MCPClient {
_ = try request(method: "initialize", params: [
"clientInfo": [
"name": "OpenComputerUseSmokeSuite",
- "version": "0.1.9",
+ "version": "0.1.10",
],
"capabilities": [:],
"protocolVersion": "2025-03-26",
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index a9a9f1a..0375993 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -5,7 +5,7 @@
## 当前目录结构
- `apps/OpenComputerUse`
- 主入口,负责 `mcp`、`doctor`、`list-apps`、`snapshot`、`turn-ended` 等 CLI 命令,以及 `-h` / `--help` / `-v` / `--version` 这类全局参数;不带参数启动时默认进入无 Dock 图标的 app 模式权限引导窗口,`doctor` 在检测到缺失权限时也会直接拉起这套 onboarding UI。
+ 主入口,负责 `mcp`、`doctor`、`list-apps`、`snapshot`、`turn-ended` 等 CLI 命令,以及 `-h` / `--help` / `-v` / `--version` 这类全局参数;不带参数启动时会先检查权限,只有缺失时才进入无 Dock 图标的 app 模式权限引导窗口,`doctor` 也只会在检测到缺失权限时拉起这套 onboarding UI。
- `apps/OpenComputerUseFixture`
本地 GUI fixture app,用来承载低风险、可预测的点击/输入/滚动/拖拽验证路径。
- `apps/OpenComputerUseSmokeSuite`
@@ -29,9 +29,9 @@
- `OpenComputerUse` 默认 app 模式会拉起 `PermissionOnboardingApp`。
- app bundle 以 `LSUIElement` agent-style 形态运行,默认不在 Dock 暴露常驻图标,但仍可按需显示权限窗口。
-- 主窗口负责渲染 `Accessibility` / `Screen & System Audio Recording` 两类权限卡片、`Allow` / `Done` 状态和 relaunch 后的状态收敛。
-- 辅助 drag panel 会跳转到对应的 `System Settings` 页面;默认保持在窗口右侧内容区下方居中,并优先跟随当前权限页 `+ / -` 控制行的垂直位置,只有拿不到控件几何时才回退到窗口底边,避免在不同权限页里掉到屏幕最下方。
-- 权限状态优先基于 TCC 持久授权记录判断,避免 CLI 子进程与 GUI app 对授权状态看到不一致的结果。
+- 主窗口负责渲染 `Accessibility` / `Screen & System Audio Recording` 两类权限卡片、`Allow` / `Done` 状态和 relaunch 后的状态收敛;当两项权限都已完成时会自动关闭,不再要求用户手动退出。
+- 辅助 drag panel 会跳转到对应的 `System Settings` 页面;默认保持在窗口右侧内容区下方居中并固定贴近窗口底边,不再依赖实时扫描权限页内部 `+ / -` 控件行;窗口层级上会显式排在当前 `System Settings` 窗口之上,避免被权限列表内容盖住,同时尽量减少对系统设置自身滚动区域的干扰。
+- 权限状态优先基于 TCC 持久授权记录判断,避免 CLI 子进程与 GUI app 对授权状态看到不一致的结果;同时会兼容 bundle-id 和路径型授权记录,并在源码启动场景下优先认 npm 全局安装后的稳定 `.app` 路径,仓库内 `dist/` 产物只作为开发兜底。
### 2. MCP 层
diff --git a/docs/RELIABILITY.md b/docs/RELIABILITY.md
index c3f3db8..2c0e86b 100644
--- a/docs/RELIABILITY.md
+++ b/docs/RELIABILITY.md
@@ -17,7 +17,7 @@
## 当前故障排查顺序
-1. 先跑 `.build/debug/OpenComputerUse doctor`,确认权限状态;如果缺权限,命令会直接拉起权限 onboarding 窗口。
+1. 先跑 `.build/debug/OpenComputerUse doctor`,确认权限状态;如果缺权限,命令会直接拉起权限 onboarding 窗口,已全部授权则只打印状态并退出。
2. 用 `.build/debug/OpenComputerUse list-apps` 确认目标 app 是否被发现。
3. 用 `.build/debug/OpenComputerUse snapshot <app>` 看是 transport 问题还是 snapshot / action 问题。
4. 如果只想验证仓库基线,直接跑 fixture + smoke,不要先在复杂第三方 app 上排查。
diff --git a/docs/histories/2026-04/20260417-2350-fix-permission-accessory-panel-ordering.md b/docs/histories/2026-04/20260417-2350-fix-permission-accessory-panel-ordering.md
new file mode 100644
index 0000000..3989abe
--- /dev/null
+++ b/docs/histories/2026-04/20260417-2350-fix-permission-accessory-panel-ordering.md
@@ -0,0 +1,33 @@
+## [2026-04-17 23:50] | Task: 修复权限拖拽面板被系统设置窗口遮挡
+
+### 🤖 Execution Context
+* **Agent ID**: `codex`
+* **Base Model**: `gpt-5.4`
+* **Runtime**: `Codex CLI on macOS`
+
+### 📥 User Query
+> 权限引导里的拖拽提示条还被 `System Settings` 窗口盖住;需要确保它显示在系统设置窗口上面。
+
+### 🛠 Changes Overview
+**Scope:** `apps/OpenComputerUse`, `docs/`
+
+**Key Actions:**
+- **[Window Ordering]**: 给权限辅助 panel 改成 `.floating` 层级,并在显示时显式 `order(.above, relativeTo:)` 到当前 `System Settings` 主窗口之上。
+- **[Window Targeting]**: 从 `CGWindowList` 里同时读取 `System Settings` 的 bounds 和 `windowNumber`,让定位逻辑和排序逻辑都基于同一个真实窗口上下文。
+- **[AX Polling Tuning]**: 把 controls row 的 AX 扫描改成低频缓存,只在滚动/拖动时强制刷新,避免高频遍历 `System Settings` AX 树引发左侧滚动条反复抽动。
+- **[Anchor Clamp & Reorder Debounce]**: 只有在目标 `System Settings` 窗口编号变化时才重新 `order(.above)`,并给 controls row 跟随加了向上抬升上限;滚到中段后不再把提示条带到列表中间,而是回退到窗口底边附近。
+- **[Remove AX Anchor Scanning]**: 最终移除了对 `System Settings` 内部 `+ / -` 控件行的定时/事件驱动 AX 探测,辅助条改为仅根据窗口 bounds 固定贴底,彻底切断对系统设置 UI 树的持续跨进程访问。
+- **[Coordinate System Fix]**: 把 `CGWindowList` 返回的 Quartz window bounds 先转换成 AppKit 屏幕坐标,再参与 panel 定位,修正窗口上下拖动时辅助条反向漂移的问题。
+- **[Drag Bundle Fallback]**: 当权限引导是通过 `swift run OpenComputerUse` 启动时,拖拽 tile 现在会自动回退到仓库内 `dist/Open Computer Use.app`,避免因为当前进程不是 `.app` bundle 而导致无法拖出权限条目。
+- **[Permission Identity Alignment]**: 权限状态查询不再只看 `Bundle.main.bundleIdentifier`;当 onboarding 实际引导用户拖入仓库内打包好的 `.app` 时,TCC 查询会改用那个真实 app bundle 的 identifier,避免列表里已经出现 `Open Computer Use` 但 UI 仍然不显示 `Done`。
+- **[Valid Bundle Guard]**: 回退到 `dist/Open Computer Use.app` 时会先验证它是否包含 `Info.plist`、可执行文件且 bundle id 正确,避免把空壳目录拖进系统设置后出现无图标、拖拽角标异常和权限状态不收敛的问题。
+- **[Path-Based TCC Detection]**: 适配 macOS TCC 把 `Open Computer Use.app` 授权记录存成 `client_type=1` 路径项的情况;权限查询现在会同时检查 app 路径和 bundle identifier,不再因为系统设置里已授权但数据库 key 不是 bundle id 而卡在 `Allow`。
+- **[Docs Sync]**: 更新架构文档,补充这块权限引导面板现在会保持在 `System Settings` 窗口之上的行为说明。
+
+### 🧠 Design Intent (Why)
+这个问题一半是窗口层级,一半是刷新策略。原先 panel 处在 `.normal` 且只做 `orderFront`,遇到前台的 `System Settings` 普通窗口时很容易被同层窗口压住;同时我们为了贴近 `+ / -` 控件行,持续通过 Accessibility IPC 读取 `System Settings` 的内部 UI 树。对这类 SwiftUI 系统页面,这种“读”并不是完全静态、无副作用的,足以把滚动区域和 overlay scrollbar 的重绘节奏带起来。最终收敛方案是把 panel 提升到辅助浮层、显式相对目标窗口排序,并完全放弃内部 AX 锚点扫描,只按窗口 bounds 固定贴底,这样才能稳定满足“始终盖在窗口上面且不扰动系统设置自身滚动表现”的要求。
+
+### 📁 Files Modified
+- `apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift`
+- `docs/ARCHITECTURE.md`
+- `docs/histories/2026-04/20260417-2350-fix-permission-accessory-panel-ordering.md`
diff --git a/docs/histories/2026-04/20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md b/docs/histories/2026-04/20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md
new file mode 100644
index 0000000..97a9ba6
--- /dev/null
+++ b/docs/histories/2026-04/20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md
@@ -0,0 +1,32 @@
+## [2026-04-18 00:15] | Task: 收口权限 bundle 身份并简化 onboarding 生命周期
+
+### 🤖 Execution Context
+* **Agent ID**: `codex`
+* **Base Model**: `gpt-5.4`
+* **Runtime**: `Codex CLI on macOS`
+
+### 📥 User Query
+> 把 bundle identifier 改成 `com.ifuryst.opencomputeruse`,未来名字都按这个走;权限长期以 `npm install -g open-computer-use` 安装后的路径为准。另外已全部授权时不要再反复弹 onboarding,授权完成后窗口要自动关闭。
+
+### 🛠 Changes Overview
+**Scope:** `apps/OpenComputerUse`, `packages/OpenComputerUseKit`, `scripts/`, `docs/`
+
+**Key Actions:**
+- **[Bundle Identity]**: 把 app bundle identifier 从 `dev.opencodex.OpenComputerUse` 统一改成 `com.ifuryst.opencomputeruse`,并同步更新打包产物校验逻辑。
+- **[Onboarding Lifecycle]**: 默认启动和 `doctor` 都先检查权限;如果两项已授权,则不再弹出 onboarding。窗口内两项权限都完成后,会自动关闭并退出 app。
+- **[Stable Permission Target]**: 文档与权限识别逻辑统一强调 npm 全局安装后的 `Open Computer Use.app` 是长期授权对象,避免把源码仓库里的临时 `dist` 路径当成最终稳定身份。
+- **[NPM Path Priority]**: 当源码启动时,权限识别和拖拽目标会优先寻找 npm 全局安装目录里的 `Open Computer Use.app`;只有没有全局安装产物时才回退到仓库 `dist/`,进一步减少开发态路径参与长期授权身份的概率。
+
+### 🧠 Design Intent (Why)
+权限体验要想接近“只授权一次,以后升级不重复折腾”,核心不是继续堆更多检测分支,而是尽量收口到一个稳定 bundle 身份和稳定安装路径。与此同时,onboarding 作为一次性修复流程,不应该在权限已经齐全时继续打扰用户,也不应该在最后一步还要求用户手动关窗。
+
+### 📁 Files Modified
+- `apps/OpenComputerUse/Sources/OpenComputerUse/OpenComputerUseMain.swift`
+- `apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift`
+- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift`
+- `scripts/build-open-computer-use-app.sh`
+- `scripts/npm/build-packages.mjs`
+- `README.md`
+- `docs/ARCHITECTURE.md`
+- `docs/RELIABILITY.md`
+- `docs/histories/2026-04/20260418-0015-stabilize-permission-bundle-identity-and-onboarding.md`
diff --git a/docs/histories/2026-04/20260418-0035-bump-open-computer-use-to-0.1.10.md b/docs/histories/2026-04/20260418-0035-bump-open-computer-use-to-0.1.10.md
new file mode 100644
index 0000000..083096c
--- /dev/null
+++ b/docs/histories/2026-04/20260418-0035-bump-open-computer-use-to-0.1.10.md
@@ -0,0 +1,30 @@
+## [2026-04-18 00:35] | Task: 发布 0.1.10
+
+### 🤖 Execution Context
+* **Agent ID**: `codex`
+* **Base Model**: `gpt-5.4`
+* **Runtime**: `Codex CLI on macOS`
+
+### 📥 User Query
+> 加个小版本,提交改动,git tag推送
+
+### 🛠 Changes Overview
+**Scope:** `plugins/`, `packages/`, `apps/`, `scripts/`, `docs/`
+
+**Key Actions:**
+- **[Version Bump]**: 把插件 manifest、Swift/Go 侧版本常量、smoke suite 初始化版本和单测中的 client version 统一提升到 `0.1.10`。
+- **[Release Notes]**: 在发布记录中补充 `0.1.10` 的用户价值,明确这次发版聚焦权限身份稳定性与 onboarding 生命周期收口。
+- **[Release Prep]**: 为本轮权限与安装路径修复建立独立发版 history,便于后续提交、打 tag 和回溯。
+
+### 🧠 Design Intent (Why)
+这一轮用户可见变化已经跨过“本地修一修”的边界,涉及 bundle identity、权限持久化体验、npm 安装路径优先级和 onboarding 生命周期。单独发一个 patch version,可以把这些权限体验收口成一个明确的发布边界,避免后续 npm 包、tag 和历史记录继续错位。
+
+### 📁 Files Modified
+- `plugins/open-computer-use/.codex-plugin/plugin.json`
+- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift`
+- `apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift`
+- `packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift`
+- `scripts/computer-use-cli/main.go`
+- `scripts/computer-use-cli/README.md`
+- `docs/releases/feature-release-notes.md`
+- `docs/histories/2026-04/20260418-0035-bump-open-computer-use-to-0.1.10.md`
diff --git a/docs/releases/feature-release-notes.md b/docs/releases/feature-release-notes.md
index cbe88c3..30766b8 100644
--- a/docs/releases/feature-release-notes.md
+++ b/docs/releases/feature-release-notes.md
@@ -4,6 +4,7 @@
| 日期 | 功能域 | 用户价值 | 变更摘要 |
| --- | --- | --- | --- |
+| 2026-04-18 | 权限身份与 onboarding | npm 安装后的权限身份更稳定,已授权用户不会被重复弹窗打扰。 | 发布 `0.1.10`,统一 bundle identifier 为 `com.ifuryst.opencomputeruse`,让权限检测兼容路径型 TCC 记录并优先认 npm 全局安装后的 app;同时让 `doctor` / 默认启动在权限齐全时不再弹出 onboarding,完成授权后自动关窗。 |
| 2026-04-17 | 发布稳定性 | release workflow 不再因为 Xcode 26 的 CoreFoundation 类型检查而在构建阶段提前失败。 | 发布 `0.1.9`,修复权限引导窗口里 `AXUIElement` 属性读取在 `macos-26` / Xcode 26.2 下的编译错误,恢复 npm release artifact 构建链路。 |
| 2026-04-17 | 权限引导与安装 | 权限授权浮窗在 `Allow` 后不再掉到屏幕底部,且仓库继续提供稳定的一键安装/发布版本。 | 发布 `0.1.8`,收口 `System Settings` 跟随 panel 的定位修复,并同步更新插件、CLI、smoke/test 与发布文档中的版本号。 |
| 2026-04-08 | 模板仓库 | 提供了一套可直接用于新项目启动的 Agent-first 基础模板。 | 补齐了 AGENTS 入口、execution plan、history、release note、CI/CD 和供应链安全骨架。 |
diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/OpenComputerUseVersion.swift
index 90dc174..eb89a62 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.9"
+public let openComputerUseVersion = "0.1.10"
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 74393c8..de23669 100644
--- a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift
+++ b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/Permissions.swift
@@ -99,11 +99,40 @@ public struct PermissionDiagnostics: Sendable {
public enum PermissionSupport {
public static let bundleDisplayName = "Open Computer Use"
- public static let bundleIdentifier = "dev.opencodex.OpenComputerUse"
+ public static let bundleIdentifier = "com.ifuryst.opencomputeruse"
+ private static let npmPackageNames = [
+ "open-computer-use",
+ "open-computer-use-mcp",
+ "open-codex-computer-use-mcp",
+ ]
public static func currentAppBundleURL() -> URL? {
- let bundleURL = Bundle.main.bundleURL
- return bundleURL.pathExtension == "app" ? bundleURL : nil
+ if let bundleURL = resolvedMainAppBundleURL() {
+ return bundleURL
+ }
+
+ return preferredInstalledAppBundleURL() ?? fallbackDevelopmentAppBundleURL()
+ }
+
+ public static func currentPermissionClients() -> [PermissionClientRecord] {
+ var records: [PermissionClientRecord] = []
+
+ if let bundleURL = currentAppBundleURL()?.standardizedFileURL {
+ records.append(PermissionClientRecord(identifier: bundleURL.path, type: 1))
+
+ if let bundle = Bundle(url: bundleURL),
+ let resolvedBundleIdentifier = bundle.bundleIdentifier {
+ records.append(PermissionClientRecord(identifier: resolvedBundleIdentifier, type: 0))
+ }
+ } else if let mainBundleIdentifier = Bundle.main.bundleIdentifier {
+ records.append(PermissionClientRecord(identifier: mainBundleIdentifier, type: 0))
+ }
+
+ if !records.contains(where: { $0.identifier == bundleIdentifier && $0.type == 0 }) {
+ records.append(PermissionClientRecord(identifier: bundleIdentifier, type: 0))
+ }
+
+ return records
}
public static func openSystemSettings(for permission: SystemPermissionKind) {
@@ -114,6 +143,108 @@ public enum PermissionSupport {
let options: NSDictionary = ["AXTrustedCheckOptionPrompt": true]
_ = AXIsProcessTrustedWithOptions(options)
}
+
+ private static func preferredInstalledAppBundleURL() -> URL? {
+ for nodeModulesRoot in npmGlobalNodeModulesRoots() {
+ for packageName in npmPackageNames {
+ let candidate = nodeModulesRoot
+ .appendingPathComponent(packageName, isDirectory: true)
+ .appendingPathComponent("dist", isDirectory: true)
+ .appendingPathComponent("\(bundleDisplayName).app", isDirectory: true)
+
+ if isValidAppBundle(candidate) {
+ return candidate
+ }
+ }
+ }
+
+ return nil
+ }
+
+ private static func fallbackDevelopmentAppBundleURL() -> URL? {
+ guard let executableURL = Bundle.main.executableURL?.standardizedFileURL else {
+ return nil
+ }
+
+ var directoryURL = executableURL.deletingLastPathComponent()
+
+ while directoryURL.path != "/" {
+ let candidate = directoryURL
+ .appendingPathComponent("dist", isDirectory: true)
+ .appendingPathComponent("\(bundleDisplayName).app", isDirectory: true)
+
+ if isValidAppBundle(candidate) {
+ return candidate
+ }
+
+ let parentURL = directoryURL.deletingLastPathComponent()
+ if parentURL == directoryURL {
+ break
+ }
+ directoryURL = parentURL
+ }
+
+ return nil
+ }
+
+ private static func npmGlobalNodeModulesRoots() -> [URL] {
+ let env = ProcessInfo.processInfo.environment
+ let candidatePrefixes = [
+ env["npm_config_prefix"],
+ env["NPM_CONFIG_PREFIX"],
+ env["PREFIX"],
+ NSHomeDirectory() + "/.npm-global",
+ "/opt/homebrew",
+ "/usr/local",
+ ]
+ .compactMap { $0 }
+ .map { URL(fileURLWithPath: $0, isDirectory: true) }
+
+ var roots: [URL] = []
+ var seenPaths = Set<String>()
+
+ for prefix in candidatePrefixes {
+ let root = prefix.appendingPathComponent("lib", isDirectory: true)
+ .appendingPathComponent("node_modules", isDirectory: true)
+ .standardizedFileURL
+
+ if seenPaths.insert(root.path).inserted {
+ roots.append(root)
+ }
+ }
+
+ return roots
+ }
+
+ private static func resolvedMainAppBundleURL() -> URL? {
+ let bundleURL = Bundle.main.bundleURL.standardizedFileURL
+ guard bundleURL.pathExtension == "app", isValidAppBundle(bundleURL) else {
+ return nil
+ }
+
+ return bundleURL
+ }
+
+ private static func isValidAppBundle(_ bundleURL: URL) -> Bool {
+ let fileManager = FileManager.default
+ let infoPlistURL = bundleURL.appendingPathComponent("Contents/Info.plist")
+ guard fileManager.fileExists(atPath: infoPlistURL.path),
+ let bundle = Bundle(url: bundleURL),
+ let executableName = bundle.object(forInfoDictionaryKey: kCFBundleExecutableKey as String) as? String,
+ !executableName.isEmpty,
+ bundle.bundleIdentifier == bundleIdentifier
+ else {
+ return false
+ }
+
+ let executableURL = bundleURL.appendingPathComponent("Contents/MacOS/\(executableName)")
+ return fileManager.fileExists(atPath: executableURL.path)
+ }
+}
+
+public struct PermissionClientRecord: Sendable, Equatable {
+ public let identifier: String
+ public let type: Int32
}
private struct TCCAuthorizationStore {
@@ -122,9 +253,10 @@ private struct TCCAuthorizationStore {
static var current: TCCAuthorizationStore {
let database = TCCDatabase(path: "/Library/Application Support/com.apple.TCC/TCC.db")
+ let clients = PermissionSupport.currentPermissionClients()
return TCCAuthorizationStore(
- accessibility: database.authorization(for: .accessibility),
- screenRecording: database.authorization(for: .screenRecording)
+ accessibility: database.authorization(for: .accessibility, clients: clients),
+ screenRecording: database.authorization(for: .screenRecording, clients: clients)
)
}
}
@@ -142,8 +274,8 @@ private struct TCCDatabase {
self.path = path
}
- func authorization(for service: Service) -> Bool? {
- guard let bundleIdentifier = Bundle.main.bundleIdentifier else {
+ func authorization(for service: Service, clients: [PermissionClientRecord]) -> Bool? {
+ guard !clients.isEmpty else {
return nil
}
@@ -159,27 +291,33 @@ private struct TCCDatabase {
let query = """
SELECT auth_value
FROM access
- WHERE service = ? AND client = ?
+ WHERE service = ? AND client = ? AND client_type = ?
ORDER BY last_modified DESC
LIMIT 1;
"""
- var statement: OpaquePointer?
- guard sqlite3_prepare_v2(database, query, -1, &statement, nil) == SQLITE_OK else {
- if statement != nil {
- sqlite3_finalize(statement)
+ for client in clients {
+ var statement: OpaquePointer?
+ guard sqlite3_prepare_v2(database, query, -1, &statement, nil) == SQLITE_OK else {
+ if statement != nil {
+ sqlite3_finalize(statement)
+ }
+ return nil
}
- return nil
- }
- defer { sqlite3_finalize(statement) }
- sqlite3_bind_text(statement, 1, service.rawValue, -1, sqliteTransient)
- sqlite3_bind_text(statement, 2, bundleIdentifier, -1, sqliteTransient)
+ sqlite3_bind_text(statement, 1, service.rawValue, -1, sqliteTransient)
+ sqlite3_bind_text(statement, 2, client.identifier, -1, sqliteTransient)
+ sqlite3_bind_int(statement, 3, client.type)
- guard sqlite3_step(statement) == SQLITE_ROW else {
- return false
+ if sqlite3_step(statement) == SQLITE_ROW {
+ let authorized = sqlite3_column_int(statement, 0) == 2
+ sqlite3_finalize(statement)
+ return authorized
+ }
+
+ sqlite3_finalize(statement)
}
- return sqlite3_column_int(statement, 0) == 2
+ return false
}
}
diff --git a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift
index d05dc89..a6ac8aa 100644
--- a/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift
+++ b/packages/OpenComputerUseKit/Tests/OpenComputerUseKitTests/OpenComputerUseKitTests.swift
@@ -83,7 +83,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.9"},"capabilities":{}}}"#)
+ let response = server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.10"},"capabilities":{}}}"#)
XCTAssertNotNil(response)
XCTAssertTrue(response!.contains(#""name":"open-computer-use""#))
XCTAssertTrue(response!.contains(#""tools":{"listChanged":false}"#))
@@ -92,7 +92,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.9"},"capabilities":{}}}"#)
+ server.handle(line: #"{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","clientInfo":{"name":"test","version":"0.1.10"},"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 db9579a..9df8c0e 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.9",
+ "version": "0.1.10",
"description": "Open-source macOS Computer Use MCP server packaged as a Codex plugin.",
"author": {
"name": "Leo",
diff --git a/scripts/build-open-computer-use-app.sh b/scripts/build-open-computer-use-app.sh
index bb1dcfa..20458ad 100755
--- a/scripts/build-open-computer-use-app.sh
+++ b/scripts/build-open-computer-use-app.sh
@@ -152,7 +152,7 @@ cat > "${contents_dir}/Info.plist" <<PLIST
<key>CFBundleIconFile</key>
<string>${bundle_icon_name}</string>
<key>CFBundleIdentifier</key>
- <string>dev.opencodex.OpenComputerUse</string>
+ <string>com.ifuryst.opencomputeruse</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
diff --git a/scripts/computer-use-cli/README.md b/scripts/computer-use-cli/README.md
index 84d4c0f..b6671d0 100644
--- a/scripts/computer-use-cli/README.md
+++ b/scripts/computer-use-cli/README.md
@@ -85,7 +85,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.9/scripts/launch-open-computer-use.sh
+ --server-bin ~/.codex/plugins/cache/open-computer-use-local/open-computer-use/0.1.10/scripts/launch-open-computer-use.sh
```
Example working invocation against the official bundled `computer-use`:
diff --git a/scripts/computer-use-cli/main.go b/scripts/computer-use-cli/main.go
index 256753c..73c8a74 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.9"
+ cliVersion = "0.1.10"
defaultTimeout = 60 * time.Second
pluginRootEnvVar = "COMPUTER_USE_PLUGIN_ROOT"
serverBinEnvVar = "COMPUTER_USE_SERVER_BIN"
diff --git a/scripts/npm/build-packages.mjs b/scripts/npm/build-packages.mjs
index f807265..667e95e 100644
--- a/scripts/npm/build-packages.mjs
+++ b/scripts/npm/build-packages.mjs
@@ -298,7 +298,7 @@ This package bundles a ready-to-run \`${appBundleName}\`, the Codex plugin metad
npm install -g ${packageName}
\`\`\`
-After install, run \`open-computer-use doctor\` first. If macOS \`Accessibility\` or \`Screen Recording\` permission is missing, it will open the permission onboarding window and tell you what still needs to be granted.
+After install, run \`open-computer-use doctor\` first. If macOS \`Accessibility\` or \`Screen Recording\` permission is missing, it will open the permission onboarding window and tell you what still needs to be granted. If everything is already granted, it just prints the status and exits.
## MCP config
@@ -315,7 +315,7 @@ If your MCP client accepts a stdio-style \`mcpServers\` JSON config, this is the
}
\`\`\`
-In practice, using this package as MCP is: global install, add the JSON config, then grant macOS \`Accessibility\` and \`Screen Recording\` permission to the host terminal or app on first use.
+In practice, using this package as MCP is: global install, add the JSON config, then grant macOS \`Accessibility\` and \`Screen Recording\` permission to the bundled npm-installed \`Open Computer Use.app\` on first use.
Package page: https://www.npmjs.com/package/${packageName}
@@ -334,6 +334,7 @@ open-computer-use install-claude-mcp
open-computer-use install-codex-mcp
# Check permissions first; if Accessibility / Screen Recording is missing, open the permission onboarding window
+# If both are already granted, this just prints the status and exits
open-computer-use doctor
# Start the stdio MCP server for Claude Desktop, Cursor, Cline, or another MCP client