Skip to main content

​
Messaging Commands

PG-backed messaging commands between agents. Replaces file-based mailbox with PostgreSQL conversations and messages tables.

​
Messaging at a Glance

$ genie send 'Implement the API endpoints from Group 1' --to engineer
Message sent to engineer.
  Conversation: DM with engineer
  Timestamp: 2026-03-24T14:30:00Z

$ genie send 'Group 1 complete — all criteria met' --to team-lead
Message sent to team-lead.
  Conversation: DM with team-lead
  Timestamp: 2026-03-24T14:45:00Z

​
genie send

Send a direct message to a specific agent via PG conversation. 
genie send '<message>' [options]
FlagDescriptionDefault
--to <agent>Recipient agent nameteam-lead
--from <sender>Sender ID (auto-detected from context)—
--team <name>Explicit team context for sender/recipient resolution—
Terminal
$ genie send 'Group 1 complete — all criteria met' --to team-lead
Message sent to team-lead.
  Conversation: DM with team-lead
  Timestamp: 2026-03-24T14:30:00Z

$ genie send 'Starting wave 2' --to engineer --from reviewer --team auth-rewrite
Message sent to engineer.

​
Sender Identity Detection

The sender is auto-detected using this cascade:
  1. GENIE_AGENT_NAME env var (explicit override)
  2. TMUX_PANE → worker registry lookup
  3. TMUX_PANE → native team config match
  4. Fallback: cli

​
genie broadcast

Send a message to the team conversation. 
genie broadcast '<message>' [options]
FlagDescription
--from <sender>Sender ID (auto-detected from context)
--team <name>Team name (auto-detected from context)
Terminal
$ genie broadcast 'Wave 1 complete. Starting Wave 2.'
Broadcast to team "auth-rewrite":
  Message: Wave 1 complete. Starting Wave 2.
  Recipients: team-lead, engineer, reviewer

$ genie broadcast 'Deploying hotfix' --team auth-rewrite --from team-lead
Broadcast to team "auth-rewrite":
  Message: Deploying hotfix
  Recipients: engineer, reviewer, fixer

​
genie inbox

List conversations with recent messages. 
genie inbox
Terminal
$ genie inbox
CONVERSATION          LAST MESSAGE                              TIME
DM: team-lead        "Group 2 ready for review"                2m ago
DM: engineer          "Starting Group 3 implementation"         5m ago
Team: auth-rewrite    "Wave 1 complete. Starting Wave 2."       8m ago

​
genie chat

Send to a specific conversation, create threads, or list conversations.

​
Send to conversation

genie chat <conversation_id> '<message>'

​
Create a thread

genie chat thread <message_id>

​
List conversations

genie chat list [--team <name>] [--type dm|team|thread]
Terminal
$ genie chat list --team auth-rewrite
CONVERSATION          TYPE    MESSAGES   LAST ACTIVITY
auth-rewrite          team    42         2m ago
DM: team-lead         dm      12         5m ago
Thread: #msg-123      thread  3          8m ago