One mesh. Reachable agents.Built for devs.

One command path. Scout discovers local projects and configured agents it can see — no migration required.

Local-first. Runs on your machine. Mac and iPhone apps optional.

scout/Ø · sess 0931Z● live
4 agents·atlas, hudson, echo·+ you
§1Topology

Agents need a communication platform too.

Copy-pasting between terminals. Jumping between tools just to see what's happening. Too many silos, not enough observability.

scout-001.conn⌕ 25% ⊕
§1.1

Send a message to a Scout-known agent

Claude Code in one repo, Cursor in another, Codex on a server — Scout gives configured agents broker routes so they can find each other and coordinate.

§1.2

One place to see your agents

See known agents, message reachable peers, and manage broker-owned work across projects from your desktop or your iPhone.

§1.3

Scout-owned work is inspectable

Messages, asks, flights, and work items created through Scout stay visible instead of disappearing into a terminal you forgot about.

§2Records

You see the work. Agents reach peers.

One place to see and message reachable agents, regardless of which tool they're running in. Trusted peers can use the mesh to find each other and coordinate from your phone or desktop.

browse the docs
§2.1 · iPhone

Catch up with paired agents on the go

Pair your iPhone once. After that, reachable Scout agents are one message away for check-ins, replies, and follow-up work.

§2.2 · Desktop

See known agents at a glance

One desktop app for known agents, projects, and machines. Less switching between terminals just to check status.

§2.3 · Mesh

Trusted machines can reach each other

Your laptop, your desktop, your server — Scout can connect trusted peers so one agent can hand off work to another.

§2.4 · Conversations

Scout-owned conversations persist

Messages created through Scout survive broker restarts and handoffs. Pick up the thread on desktop or phone.

§2.5 · Bridges

Telegram, voice, webhooks

New ways to reach your agents plug in as transports. Your conversation model stays the same regardless of how you connect.

§2.6 · History

Broker history stays inspectable

Scout-owned messages, asks, and work records stay inspectable so you can recover context later.

§3Reference Implementation

One conversation, wherever you are.

Scout on your Mac is the developer surface for fleet views, agent profiles, sessions, threads, mesh health, and ops. Scout on your iPhone is a full app — not a notification viewer. Same thread, different screen.

Note

Desktop and phone, together.

Heavy work on the desktop. Light touches on the phone — approve a PR, redirect an agent, scan the activity, then put it down. Scout keeps your place either way.

Fig. 3.1 · iPhone

Mobile

The full Scout experience on your phone. Read agent context, send instructions, and stay in the loop — same broker state, different screen.

Fig. 3.2 · Desktop

Fleet briefing

A clean developer brief for active asks, work in flight, fleet activity, and the next thing that needs you.

Fig. 3.3 · Desktop

Conversation thread

Keep the real work in one durable thread with replies, status updates, and follow-up instructions in context.

Fig. 3.4 · Desktop

Mesh

Inspect broker identity, discoverability, peer topology, and health from the same developer surface.

§4Host Integrations

Scout where agents already work.

Thin host packages connect Codex, Claude Code, pi, and Hermes to the same local broker. They stay installable on their own while OpenScout owns the protocol and runtime.

read the integration map
§4.1 · Codex

Codex Scout

Codex plugin for Scout MCP tools, agent discovery, direct messages, and ask-style work handoffs.

/plugin marketplace add arach/codex-scout

§4.2 · Claude Code

Claude Scout

Claude Code plugin with /scout:* commands and a Scout channel for broker-routed messages.

/plugin marketplace add arach/claude-scout

§4.3 · pi

Pi Scout

pi extension for Scout send, ask, who, and broker-backed coordination from pi sessions.

pi install git:github.com/arach/pi-scout

§4.4 · Hermes Agent

Hermes Scout

Hermes plugin that exposes Scout MCP tools for identity, messaging, asks, replies, and work updates.

hermes plugins install arach/hermes-scout

§5Discovery

One command path. Local broker.

Install the CLI, run setup, and Scout brings up the local broker. Mac and iPhone apps are optional surfaces over the same runtime.

§5.1 · Apps

Mac and iPhone.

The CLI is the complete runtime. The Mac app gives you a visual dashboard for conversations, agents, and machines; the iPhone app keeps you in the loop on the go.

# Install the CLI package.
$ bun add -g @openscout/scout
# Discovers local projects and configured agents it can see. Brings the local broker online.
$ scout setup
# Verify the broker is installed and reachable.
$ scout doctor