Agent skills

Ghostex ships four bundled agent skills that teach coding agents how to use Ghostex-specific workflows. Each skill is an explicit per-skill install — copied to ~/agents/skills — not a hidden side effect of CLI setup.

Skills~/agents/skillsCLI

Bundled skills

Option	What it does
`ghostex-browser-use`	Inspect Ghostex browser panes, read console logs, capture screenshots, and interact through the Ghostex Browser Use MCP server.
`ghostex-computer-use`	Native macOS app automation through Cua Driver, including Accessibility and Screen Recording requirements.
`ghostex-agent-orchestration`	Coordinate Ghostex sessions through CLI commands: create panes, send messages, read output, focus, sleep, wake, and kill.
`ghostex-generate-title`	Generate concise session titles and submit rename-command in the current session.

Install commands

ghostex browser install-skill
ghostex computer-use install-skill
ghostex agent-orchestration install-skill
ghostex generate-title install-skill

Install from first-launch setup, Settings → Integrations (Bundled Agent Skills panel), or the CLI. Each row shows install status and can be updated independently. Skill installs require the Ghostex CLI to be present (auto-linked with the app).

Ghostex Browser Use

Teaches agents the ghostex browser mcp workflow: list pages, select targets, read console logs, take snapshots, click/fill, and capture screenshots.

[mcp_servers.ghostex-browser]
command = "ghostex"
args = ["browser", "mcp"]

Ghostex Computer Use

A wrapper around $cua-driver. Agents check permissions with prompt:false, start the daemon if needed, and drive apps through the accessibility tree using element_index values.

Desktop Control must be installed (Cua Driver + skill).
Use $ghostex-browser-use for embedded browser panes instead.

Ghostex Agent Orchestration

Core loop for cross-session coordination:

ghostex sessions --json
ghostex state
ghostex send-message <selector> "Status check: summarize blockers."
ghostex read-text <selector> --lines 80 --json
ghostex focus <selector> --json
ghostex sleep <selector> --json
ghostex wake <selector> --json

Treat ghostex --help as the source of truth for current command names, selectors, flags, and aliases. Do not drive panes through raw zmx/tmux when a Ghostex CLI command exists.

Ghostex Generate Title

Rules for generated titles:

Keep titles under 60 characters.
Summarize actual work done, not conversation vibe.
Use plain title case; avoid quotes, punctuation, and emojis.
Submit via rename-command, not send-text + send-enter.

Self-session selector priority:

GHOSTEX_GLOBAL_SESSION_REF → GHOSTEX_SESSION_ID → ZMX_SESSION

Ghostex Manage Beads

A fifth skill (ghostex-manage-beads) ships in the repo for Kanban bead workflows. Use gx bd (not raw bd) so commands run through Ghostex's bundled Beads binary.

gx bd list --json
gx bd create "Review layout fix" --type task --priority P2 --labels review
gx bd update <id> --status review
gx bd comment <id> "Associated session: Ghostex $GHOSTEX_GLOBAL_SESSION_REF"

Related docs

Browser use

Computer use

Cross-model orchestration

First launch