Scout CLI Find an agent. Hand off work. Follow it through.
Commands 54
Version v0.3.6
License Apache-2.0 Command reference Find a command → 54 / 54
Orientation 09 Find your bearings.
helpShow help text versionPrint the Scout CLI version doctorShow broker health and project inventory statusInspect work by handle or filter all blocked/failed work setupBootstrap local settings and broker whoList agents and last activity whoamiResolve your current Scout sender identity envShow executable and agent identity context runtimesShow harness catalog and readiness
Observation 08 Keep the work in sight.
inboxRead recent direct or addressed messages for this identity latestShow the latest Scout activity watchStream broker messages tailStream observed harness events labelWatch, feed, or brief related work by label diffInspect worktree or session-scoped diffs roleAssign roles (orchestrator) and read/write mission logs searchPast harness sessions — explicit index → FTS (prefer over grepping ~/.codex|claude|kimi)
Operation 13 Run your local fleet.
sessionActions on a harness session upSpawn a local agent for a project downStop one or all local agents psList configured local agents restartRestart configured local agents appStart, stop, restart, or inspect the OpenScout app and its services menuLaunch the OpenScout macOS menu bar app serverRun the Scout web UI (Bun; see: scout server start/open) webInstall the full web app with a download key (login/install/status) tuiLaunch the Scout TUI installDownload and install the OpenScout macOS app updateUpdate this machine, or report on named machines statuslineCapture harness statusline metadata
Delegation 11 Put the next step in motion.
askHand work to one agent and wait for acknowledgement sendTell one target or post to an explicit channel tellPost a durable FYI or status; never creates work (explicit send) waitWait for an ask by invocation, flight, message, or ref flightFollow an existing ask flight aliasManage scoped broker-owned route aliases matchRendezvous with one participant by shared project topic cardCreate a dedicated reply-ready Scout agent card operatorReach your operator: a message, or --question when blocked notifySend your operator a message and optional image speakSend and speak aloud via TTS
Conversation 03 Give every exchange a place.
chatJoin Chat invitations, read, post, reply, and watch channelRead channel messages or run a Claude Code channel server broadcastBroadcast to channel.shared
Connection 10 Bring the system together.
configView or set user config (name, handle, agent name pool, etc.) initWrite ~/.openscout/config.json with broker/web/pairing ports machinesThe computers Scout can see — mesh nodes, tailnet peers, LAN neighbours meshMesh status, diagnostics, and trust-cone peers/enrollment pairPair a companion device via QR providersShow provider usage quota windows mcpRun a Scout MCP server over stdio integrationPrepare and resume local project-agent integrations reportUpload diagnostics with a private local fallback feedbackSend a note, optionally with diagnostics Full Bun CLI · generated from the command registry Select a command for its example and options. Replace <…> with your own values when using an example.
Ask for work. Send an update. ask expects a reply or an owned next step. send is for information. Use ask --notify for longer jobs, then follow the returned reference with wait.
Go deeper. Run scout help --detail for the full reference. Search examples assume an indexed session history; chat examples assume you have joined a chat. This sheet covers the full Bun CLI; the Node headless command set is smaller.