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 inbox
CONVERSATION          LAST MESSAGE                              TIME
DM: team-lead        "Starting Wave 2 — Groups 3,4 unblocked"  1m ago
DM: engineer          "Group 1 complete — all criteria met"      15m ago
Team: auth-fix        "Wave 1 complete. Starting Wave 2."        16m ago

$ genie broadcast 'Wave 1 complete. Starting Wave 2.'
Broadcast to team "auth-fix":
  Message: Wave 1 complete. Starting Wave 2.
  Recipients: team-lead, engineer, reviewer

$ genie chat list --team auth-fix
CONVERSATION          TYPE    MESSAGES   LAST ACTIVITY
auth-fix              team    42         1m ago
DM: team-lead         dm      12         5m ago
DM: engineer          dm      8          15m ago
Thread: #msg-201      thread  3          20m ago

`genie send`

Send a direct message to a specific agent via PG conversation.

genie send '<message>' [options]

Flag	Description	Default
`--to <agent>`	Recipient agent name	`team-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:

GENIE_AGENT_NAME env var (explicit override)
TMUX_PANE → agent registry lookup
TMUX_PANE → native team config match
Fallback: cli

`genie broadcast`

Send a message to the team conversation.

genie broadcast '<message>' [options]

Flag	Description
`--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`

Check agent inbox for recent messages.

`genie inbox list`

List conversations with recent messages.

genie inbox list [options] [agent]

Terminal

$ genie inbox list
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 inbox watch`

Watch for new messages in real-time.

genie inbox watch

`genie chat`

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

Send to conversation

genie chat send <conversationId> '<message>'

Read messages in a conversation

genie chat read [options] <conversationId>

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

Getting Started

Core Concepts

The Genie Loop

Power Skills

CLI Reference

Configuration

Security & Trust

Architecture

Observability

Hacks & Tips

Contributing

Messaging

Messaging Commands

Messaging at a Glance

`genie send`

Sender Identity Detection

`genie broadcast`

`genie inbox`

`genie inbox list`

`genie inbox watch`

`genie chat`

Send to conversation

Read messages in a conversation

Create a thread

List conversations

​Messaging Commands

​Messaging at a Glance

​genie send

​Sender Identity Detection

​genie broadcast

​genie inbox

​genie inbox list

​genie inbox watch

​genie chat

​Send to conversation

​Read messages in a conversation

​Create a thread

​List conversations

Messaging Commands

Messaging at a Glance

`genie send`

Sender Identity Detection

`genie broadcast`

`genie inbox`

`genie inbox list`

`genie inbox watch`

`genie chat`

Send to conversation

Read messages in a conversation

Create a thread

List conversations