Agent skill · manaflow-ai
cmux-cua
Drive real macOS apps from a cmux agent session via the bundled computer-use engine (accessibility tree + screenshot perception, click/type/scroll/drag, branded agent cursor). Use when an agent should see and operate GUI apps on the local Mac, when computer-use tools are missing or failing, or when explaining how to grant permissions, brand the cursor, or focus the driving session.
What it needs
About 9k tokens when loaded.
What this skill does
cmux-cua cmux bundles a local computer-use engine (packaged as cmux Computer Use with the MCP proxy named cmux-cua, from a pinned build of the manaflow-ai/cmux-cua fork) and attaches it as an MCP tool server named cmux-cua to every agent session cmux launches (Claude Code, Codex). The agent can then perceive and operate real macOS apps: read the accessibility tree, take screenshots, and click / type / scroll / drag. Everything runs locally through the bundled cmux Computer Use helper. The helper has its own TCC identity, so Accessibility and Screen Recording never belong to the main cmux app and granting Screen Recording never requires restarting cmux. Upstream telemetry and update checks are disabled at runtime. How it attaches The cmux-claude-wrapper and cmux-codex-wrapper inject cmux-cua as an MCP proxy using mcp --socket <cmux-owned socket> plus cursor-branding and state-dir env. Codex launches the exact tag-installed helper executable as its authenticated approval broker; Claude uses the bundled native-profile proxy client. The Codex wrapper additionally passes --codex-computer-use-compat; the Claude wrapper deliberately does not. No user setup per session — start claude or codex inside cmux and the corresponding tool profile is there. ComputerUseRuntimeService is the only helper lifecycle owner. It installs the nested helper under the tag-scoped ~/Library/Application Support/cmux/cmux-cua/helper/<scope>/ directory and launches that explicit app URL through LaunchServices. The native daemon uses the tag-scoped /tmp/cmux-cua-<uid>/<scope>/cmux-cua.sock; the Codex compatibility daemon uses cmux-cua-codex.sock beside it. Both fit Darwin's Unix-socket path limit and share the tag-scoped cmux Application Support state directory. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills manaflow-ai/cmux-cua