Cross-model orchestration

Ghostex lets you run Claude, Codex, Gemini, Copilot, and other agent CLIs side by side, then coordinate them through the Ghostex CLI instead of raw tmux or zmx control. Install the Agent Orchestration skill so agents know the supported command surface.

CLIMulti-agentOrchestration

Why orchestrate through Ghostex

Ghostex tracks session identity, activity (working / idle / attention), and sidebar card projection across agents.
The CLI exposes stable selectors: session ids, numeric aliases, titles, and project:title forms.
send-message, read-text, sleep, wake, and kill go through the same paths as the desktop UI and mobile companions.
Agents avoid brittle raw zmx/tmux commands when a Ghostex CLI equivalent exists.

Install the skill

ghostex agent-orchestration install-skill

This copies ghostex-agent-orchestration to ~/agents/skills. The skill documents the core loop and boundaries for coordinating work across panes.

Core loop

Inspect: ghostex sessions --json and ghostex state.
Pick stable selectors — prefer session ids from JSON output.
Act through Ghostex CLI commands.
Verify with ghostex sessions --json, ghostex read-text, ghostex wait-for, or ghostex assert-card.

ghostex sessions --json
ghostex state

Create panes and agents

ghostex create-session "Build watcher" --project-id <id> --group-id <id> --input "npm run dev"
ghostex create-agent codex --group-id <id>
ghostex send-message codex "Investigate the failing test and report findings."

Message other sessions

Option	What it does
`send-message <selector> <text>`	Type text and press Enter in another session.
`send-text <selector> <text>`	Type without Enter; follow with send-enter.
`send-enter <selector>`	Press Enter in another session.
`send-key <selector> ctrl-c`	Send control keys (ctrl-c, escape, tab, arrows).

Selectors can be an alias from the last sessions list, a session id, a provider session name, a quoted title, or project:title.

Read output and check status

ghostex read-text <selector> --lines 80 --json
ghostex read-text <selector> --visible --json
ghostex wait-for <selector> --timeout-ms 30000
ghostex assert-card <selector> --visible true

Manage sessions

ghostex focus <selector> --json
ghostex sleep <selector> --json
ghostex wake <selector> --json
ghostex kill <selector> --json

Boundaries

Use $ghostex-browser-use for embedded CEF browser panes.
Use $ghostex-computer-use for native macOS apps outside Ghostex.
Use gx find / gx f for prompt-history search across sessions (bundled zehn).
Pass explicit --project-id or --group-id when project context matters instead of relying on whichever project is focused.

Multi-model workspace layout

Ghostex supports multi-pane and multi-group project layouts. Run different agent CLIs in separate panes or groups, then use the CLI or Agent Orchestration skill to pass work between them. Session activity badges show which agents are working and which need attention without reading every terminal.

Related docs