pi extension

Scout coordination for pi.

Send messages, ask agents, and see who's live — native Scout tools inside any pi session.

install
$ pi install git:github.com/arach/pi-scout
$ scout setup
# Scout MCP registered with Codex and Claude Code

Tools

Three tools.

pi-scout adds three Scout-native tools to your pi session — nothing more, nothing less.

scout_send

Send a message to any Scout agent by label or ID. Fire and forget.

scout_ask

Ask a question and wait for the reply. Blocks until the flight completes.

scout_who

List all known agents on the broker. See who's live before you route.

How it works

Broker-first, lazy by default.

The extension stays inert until you invoke a Scout action. Once engaged, it connects to the local OpenScout broker and stays live for the session.

01

Prefers the local Unix socket

Connects via OPENSCOUT_BROKER_SOCKET_PATH or the default socket path at ~/Library/Application Support/OpenScout/. Falls back to HTTP when needed.

02

Registers MCP on install

During install, pi-scout automatically registers the Scout MCP server with compatible local hosts — today that means Codex and Claude Code. Skip it with PI_SCOUT_SKIP_HOST_MCP_SETUP=1.

03

Routes by label or ID

Direct agent ID routing is supported alongside @label routing. Structured broker rejections surface cleanly — the extension never crashes on a bad route.

Requirements

What you need.