Crew

Crew manages a team of AI agents, each running in its own tmux session with a persona.

List Active Crew

$ metateam crew list
# or
$ metateam crew

Initialize a Crew

$ metateam crew init [NAME] [--force]

Creates crew state and seeds template-backed KB entries.

Use --force to re-sync matching template entries.

Start a Crew (Bootstrap)

$ metateam crew start [--client <CLIENT>]

Bootstraps the crew via a leader persona. --client overrides client selection (for example codex).

Summon an Agent

$ metateam crew summon <NAME> [MESSAGE] [--client <CLIENT>] [--backend <BACKEND>]

--backend supports tmux or embedded.

Release an Agent

$ metateam crew release <NAME>

Send Messages

$ metateam crew message <TARGET> [MESSAGE] [--from <FROM>] [--file <FILE>...]

Target format:

Target	Meaning
agent	Agent in current crew
crew:agent	Agent in another local crew
host:crew:agent	Agent on a remote host
name1,name2	Multiple recipients
all	Broadcast current crew
all-crews	Broadcast all local crews
all-hosts	Broadcast all hosts/crews/agents

Check Recent Messages

$ metateam crew inbox

Attach to an Agent Session

$ metateam crew attach <NAME>

Capture Agent Screen

$ metateam crew screen <NAME> [-n <LINES>] [--all] [-o <FILE>] [--no-trim]

Reset an Agent Context

$ metateam crew reset <NAME>

Resets the agent session context and asks it to recall the last session.

Personas

$ metateam crew persona list
$ metateam crew persona show <NAME>
$ metateam crew persona add <NAME>
$ metateam crew persona edit <NAME>
$ metateam crew persona export <NAME>
$ metateam crew persona import <FILE>
$ metateam crew persona delete <NAME>

Communication Instructions

$ metateam crew communication show
$ metateam crew communication edit

Client-Specific Instructions

$ metateam crew client-instructions show <CLIENT>
$ metateam crew client-instructions edit <CLIENT>

Workflow Record

$ metateam crew workflow show
$ metateam crew workflow edit
$ metateam crew workflow reset

Agent Watchdog

$ metateam crew watchdog start
$ metateam crew watchdog stop
$ metateam crew watchdog status
$ metateam crew watchdog off

Dashboard

$ metateam crew dashboard [--no-resize]

Opens the crew dashboard TUI.

Clear Crew State

$ metateam crew clear

Rename / Delete a Crew

$ metateam crew rename <NAME>
$ metateam crew delete <station:crew> [--force] [--yes]

crew delete target format is station:crew (example: devmac:atlas).

Observability

• crew attach to observe an agent in real time
• crew screen to capture terminal output programmatically
• .crew/history.md for message/event history
• .crew/mail-board/ for long-form reports