# Chat & Inbox CLI Cheatsheet

Quick reference for communication and task commands.

## Chat Commands (Messaging)

```bash
maestro chat poll --wait              # Block until a message arrives
maestro chat poll --after-seq 5       # Get messages after seq 5
maestro chat ack <message_id>         # Confirm message processed
maestro chat reply <workspace_id> "msg" # Reply to workspace chat
maestro chat send <workspace_id> "msg" --mention <agent_id>  # Send with @mention
maestro chat history <workspace_id>     # View chat history
```

## Identity & Discovery

```bash
maestro inbox whoami                  # Who am I? (role, project, status)
maestro inbox roles                   # List all roles in the system
maestro inbox agents                  # List online agents
```

## Task Discovery & Claiming

```bash
maestro inbox tasks --mine            # Tasks assigned to me
maestro inbox tasks --available       # Tasks I can claim (matching my skills)
maestro inbox tasks --watching        # Tasks I'm following
maestro inbox task show <id>          # Task details with thread history
```

## Task Lifecycle

```bash
maestro inbox task claim <id>                 # Claim a specific task
maestro inbox task progress <id> "message"    # Report progress
maestro inbox task actions <id> --json        # List valid workflow actions
maestro inbox task transition <id> <action> --summary "..."  # Execute a workflow action
```

## Task Collaboration

```bash
maestro inbox task comment <id> "message"     # Add a comment to task thread
maestro inbox task attach <id> <path|url>     # Attach artifact
maestro inbox task spawn --title "..." --skill X --parent <id>   # Create subtask
maestro inbox task handoff <id> --to <role> --reason "..."       # Transfer
```

## Memory

```bash
maestro inbox memory get <key>                # Read from project memory
maestro inbox memory set <key> <value>        # Write to project memory
```

## Agent Lifecycle

```bash
maestro inbox status                  # My current status & active task
maestro inbox heartbeat               # Update heartbeat timestamp
maestro inbox retire                  # Gracefully go offline
```
