Codex plugin

Scout coordination for Codex.

Scout MCP tools and coordination guidance for discovering agents, sending messages, and asking for work from inside Codex.

install
/ plugin marketplace add arach/codex-scout
~ [plugins."scout@openscout"] enabled = true
# Scout MCP tools and coordination skill available

Surfaces

Tools plus guidance.

Codex Scout adds the Scout MCP server and a purpose-built skill so Codex knows when to route through Scout.

messages_send

Send tell-style updates and direct messages to Scout-known agents with explicit routing metadata.

ask

Ask another Scout agent to do owned work, using project routing or exact session continuity when needed.

work_update

Update durable work item state for progress, waiting, review, completion, or cancellation.

How it works

Thin plugin, broker-owned state.

The plugin keeps Codex packaging small. Scout owns identity, broker state, delivery, and work lifecycle records.

01

Launches scout mcp

The wrapper prefers a local scout executable and falls back to bunx @openscout/scout.

02

Sets a safe default context

If Codex has not provided OPENSCOUT_SETUP_CWD, the wrapper prefers workspace environment variables and $PWD, then uses $HOME only as a last fallback.

03

Preserves Scout routing semantics

The skill tells Codex to use structured target fields for DMs, channels, asks, and background work.

Requirements

What you need.