Crew

Crew manages a team of AI agents — each running in its own tmux session, each with a persona, communicating asynchronously. These commands are primarily invoked by agents (especially the team lead) during a crew session; users typically interact with crew through crew init, crew start, and crew summon.

List Active Crew

$ recalletta crew list
Crew: Atlas
  atlas   (claude) @my-machine registered
  beacon  (claude) @my-machine registered
  circuit (codex)  @my-machine registered
  drift   (codex)  @my-machine registered
  ember   (claude) @my-machine registered

Some personal information has been redacted for security and ethical considerations.

or just:

$ recalletta crew

Initialize a Crew

$ recalletta crew init

Creates the crew database and marker files. Seeds KB crew content from templates. Run this once before using crew features.

Start a Crew (Bootstrap)

$ recalletta crew start

Bootstraps the crew and onboards via the team leader persona. This summons the leader and lets them coordinate the rest.

Summon an Agent

$ recalletta crew summon <NAME> [TASK]

Summons a persona into a new tmux session. The persona's default AI client is read from the KB definition. You can override it:

$ recalletta crew summon forge "Fix the performance regression"
$ recalletta crew summon forge --client codex "Fix the regression"

The agent starts with:

• The persona's personality and expertise (from KB)
• The project's accumulated knowledge (KB entries marked important)
• The crew communication instructions
• The task you provided

Release an Agent

$ recalletta crew release <NAME>

Dismisses an agent and kills its tmux session.

Send Messages

$ recalletta crew message <TARGET> [MESSAGE]

Sends a message to one or more crew members. Supports local delivery, inter-crew, and remote delivery via the bridge. Targets are active registered agents in the current crew (from recalletta crew list), not persona templates. If crew message says "Agent not found", summon/register that persona first.

The target can be:

Target	Meaning
forge	Single agent
forge,circuit	Multiple agents (comma-separated)
all	All registered agents

Options:

Option	Purpose
--from <FROM>	Override sender name
--file <FILE>	Attach a file (remote targets only)

Example:

$ recalletta crew message drift,beacon "Ready to coordinate sections"
Delivered.

Important: Messages use tmux send-keys to deliver text into the agent's session. Avoid shell metacharacters (like *) in messages — they can break delivery. Use the mail-board for longer content.

Check Recent Messages

$ recalletta crew inbox

Shows the tail of .crew/history.md — recent messages and events.

Personas

Personas define agent personalities, roles, and default clients.

$ recalletta crew persona list           # List all personas
$ recalletta crew persona show <NAME>    # Show persona details
$ recalletta crew persona add <NAME>     # Add a new persona
$ recalletta crew persona edit <NAME>    # Edit a persona
$ recalletta crew persona export <NAME>  # Export persona to TOML
$ recalletta crew persona import <FILE>  # Import persona from TOML
$ recalletta crew persona delete <NAME>  # Delete a persona

There are built-in personas covering roles like architecture, testing, security review, and code review. Each has a default AI client (claude, codex, or gemini).

Communication Instructions

$ recalletta crew communication show     # Show default comms template
$ recalletta crew communication edit     # Edit default comms template

Client-Specific Instructions

$ recalletta crew client-instructions show <CLIENT>   # claude, codex, or gemini
$ recalletta crew client-instructions edit <CLIENT>

These are injected into the agent's session alongside the persona instructions.

Remote Bridge

For multi-machine coordination:

$ recalletta crew bridge start           # Start the HTTP bridge server
$ recalletta crew bridge stop            # Stop the bridge
$ recalletta crew list                   # Shows machines, crews, and agents

Send messages to remote crew agents via the bridge using crew message with a crew:agent target format. See Crew Bridge for details.

Workflow Record

$ recalletta crew workflow show          # Show current workflow state
$ recalletta crew workflow edit          # Edit workflow record
$ recalletta crew workflow reset         # Reset workflow

Clear Crew State

$ recalletta crew clear

Clears all crew state — deregisters all agents and resets the crew database.

Attach to an Agent Session

$ recalletta crew attach <NAME>

Attaches to an agent's tmux session for real-time observation. On macOS, crew summon opens a new terminal tab automatically. On Linux, agents run in tmux sessions and crew attach is the way to observe them.

Screenshot an Agent Session

$ recalletta crew screenshot <NAME>

Captures the tmux pane content of an agent session.

Option	Purpose
-n, --lines <N>	Lines of scrollback to include (default: visible pane only)
--all	Capture entire scrollback history
-o, --output <FILE>	Write output to file instead of stdout
--no-trim	Do not trim trailing empty lines

Agent Watchdog

$ recalletta crew watchdog start         # Start idle watchdog for current crew
$ recalletta crew watchdog stop          # Stop the watchdog
$ recalletta crew watchdog status        # Show watchdog status

Rename / Delete a Crew

$ recalletta crew rename <NEW_NAME>      # Rename the current crew
$ recalletta crew delete <NAME>          # Delete a crew from the listing

Observability

• crew attach: Attach to any agent's tmux session to see exactly what it is doing in real time
• crew screenshot: Capture an agent's terminal output programmatically
• .crew/history.md: Human-readable log of all crew events and messages
• .crew/mail-board/: Longer reports and documents exchanged between agents
• Agent sessions are saved: Every agent's AI session is captured by Recalletta, so their work is searchable later