feat(desktop-use): Inspect (AX tree) as first-class Desktop Use capability

[AruNi-01]

Summary

Makes Inspect (macOS accessibility / UI tree) a first-class Desktop Use capability alongside Capture and Control, so AppShot context.md can carry a real tree without overloading Capture.

• crates/desktop-use inspect surface (macOS AX walker)
• CLI / product split: Inspect ≠ Capture ≠ Control
• Spec updates under specs/APP/APP-052_desktop-use/

Dependency

Depends on #202 (control engine + Atmos Desktop Use host TCC). Please do not merge before #202.

After #202 lands on main, rebase this branch and re-run CI. Orthogonal to #202’s Cua pin / host packaging work.

Related

• Base shell: feat(desktop-use): APP-052 Desktop Use Settings, CLI, and AppShot capture migration #199 (merged)
• Control engine / host (merge first): feat(desktop-use): control engine pin, Atmos Desktop Use host, unified AppShot TCC #202
• Agent pointer experiment: feat(desktop-use): Agent pointer + Inspect UI tree (visible computer-use) #201 (closed; not a product base)

Type of Change

• New feature
• Bug fix
• Refactor
• Documentation

Validation

• Rebase onto post-feat(desktop-use): control engine pin, Atmos Desktop Use host, unified AppShot TCC #202 main
• cargo test -p desktop-use
• Additional: live AX inspect on macOS (manual)

Checklist

• Specs updated for Inspect split
• Tests where appropriate on this branch
• Rebased after feat(desktop-use): control engine pin, Atmos Desktop Use host, unified AppShot TCC #202

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
atmos-landing	Ready	Preview	Aug 3, 2026 6:25pm

[coderabbitai]

Warning

Review limit reached

@AruNi-01, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 18 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ee39098f-c327-40af-a41b-6f9199e925c1

📥 Commits

Reviewing files that changed from the base of the PR and between 3b55c77 and 2306a20.

⛔ Files ignored due to path filters (1)

• Cargo.lock is excluded by !**/*.lock

📒 Files selected for processing (15)

• apps/cli/src/commands/desktop_use.rs
• apps/desktop-electron/src/appshot/frontmost.ts
• apps/desktop-electron/src/desktop-use/capture.ts
• apps/desktop-electron/src/desktop-use/context.ts
• apps/desktop-electron/src/desktop-use/inspect.test.ts
• apps/desktop-electron/src/desktop-use/inspect.ts
• apps/desktop-electron/src/ipc/handlers.ts
• crates/desktop-use/Cargo.toml
• crates/desktop-use/src/inspect/macos_ax.rs
• crates/desktop-use/src/inspect/mod.rs
• crates/desktop-use/src/lib.rs
• specs/APP/APP-052_desktop-use/BRAINSTORM.md
• specs/APP/APP-052_desktop-use/PRD.md
• specs/APP/APP-052_desktop-use/TECH.md
• specs/APP/APP-052_desktop-use/TEST.md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

E2E report: ✅ Passed

30 passed · 0 failed · 2 flaky · 0 skipped · 3m 31s · 93.8% pass rate

Run

Field	Value
Workflow run	30841030403
Selected suites	smoke-routes, smoke-onboarding, smoke-app-shell, smoke-project, smoke-settings, smoke-workspace, specs
HTML report	Open report
Artifacts	playwright-html-report, playwright-json-report (14d) · videos/traces in artifacts only

Overview

Metric	Count
Passed	30
Failed	0
Flaky	2
Skipped	0
Duration	3m 31s
Pass rate	93.8%

By file

Name	Passed	Failed	Flaky	Skipped
APP-043_workspace-surface-cache.e2e.ts	2	0	0	0
APP-044_project-workspace-groups.e2e.ts	2	0	0	0
APP-048_049_api-client-ws.e2e.ts	4	0	2	0
app-shell-navigation.e2e.ts	1	0	0	0
app-shell-preferences-menu.e2e.ts	1	0	0	0
app-shell-workspace-composer.e2e.ts	1	0	0	0
app-shell-ws-session.e2e.ts	1	0	0	0
local-onboarding.e2e.ts	2	0	0	0
private-relay-onboarding.e2e.ts	1	0	0	0
project-context-route.e2e.ts	2	0	0	0
remote-onboarding.e2e.ts	1	0	0	0
route-boot.e2e.ts	7	0	0	0
settings-modal.e2e.ts	3	0	0	0
workspace-sidebar-routes.e2e.ts	2	0	0	0

By project

Name	Passed	Failed	Flaky	Skipped
chromium	26	0	1	0
mobile-chromium	4	0	1	0

All selected E2E suites passed.

[AruNi-01]

Ordering note: Merge #202 first (control engine + Atmos Desktop Use.app TCC + host AppShot capture). This Inspect PR is a follow-up; rebase onto main after #202 lands.

#201 (agent-pointer) is closed and is not a dependency for this work.