Messaging
Send messages to agents and manage conversation history.
send
Send a message to one or more agents. Supports streaming, synchronous, fire-and-forget, and conversation-scoped modes.
lettactl send <agent> <message> [options]Options
| Flag | Type | Description |
|---|---|---|
| --stream | boolean | Stream the response in real-time |
| --sync | boolean | Synchronous mode (may timeout on long responses) |
| --no-wait | boolean | Fire-and-forget — returns a run ID immediately |
| --conversation-id | string | Send message within a specific conversation (forces streaming) |
| --all | string | Send to all agents matching a glob pattern |
| --file, -f | string | Target agents from a fleet config file |
| --confirm | boolean | Skip confirmation for bulk operations |
| --timeout | number | Timeout per agent in seconds |
| --max-steps | number | Maximum processing steps |
| --enable-thinking | boolean | Enable agent reasoning/thinking |
Examples
Simple message
lettactl send my-agent 'Hello!'Streaming
lettactl send my-agent 'Tell me a story' --streamConversation-scoped
lettactl send my-agent 'Hello' --conversation-id <conv-id>Bulk message
lettactl send --all 'support-*' 'Update your greeting' --confirmFire and forget
lettactl send my-agent 'Process this' --no-waitmessages
List conversation history for an agent, or messages within a specific conversation.
lettactl get messages <agent> [options]Options
| Flag | Type | Description |
|---|---|---|
| --limit, -l | number = 10 | Number of messages to show |
| --all, -a | boolean | Show all messages |
| --system | boolean | Include system messages |
| --order | asc | desc | Sort order |
| --before | string | Messages before this ID |
| --after | string | Messages after this ID |
| --conversation-id | string | List messages from a specific conversation |
Examples
Recent messages
lettactl get messages my-agentAll messages
lettactl get messages my-agent --allWith system
lettactl get messages my-agent --system -l 20From conversation
lettactl get messages my-agent --conversation-id <conv-id>reset-messages
Clear an agent's conversation history.
lettactl reset-messages <agent> [options]Options
| Flag | Type | Description |
|---|---|---|
| --add-default | boolean | Add default initial messages after reset |
Examples
Reset
lettactl reset-messages my-agentReset with defaults
lettactl reset-messages my-agent --add-defaultcompact-messages
Summarize and compress an agent's message history to free context window space. Supports compacting conversation-scoped messages.
lettactl compact-messages <agent> [options]Options
| Flag | Type | Description |
|---|---|---|
| --conversation-id | string | Compact messages within a specific conversation |
| --model | string | LLM model to use for compaction (defaults to agent's model) |
Examples
Compact
lettactl compact-messages my-agentCompact conversation
lettactl compact-messages my-agent --conversation-id <conv-id>cancel-messages
Cancel running message processing for an agent.
lettactl cancel-messages <agent> [options]Options
| Flag | Type | Description |
|---|---|---|
| --run-ids | string | Specific run IDs to cancel |
Examples
Cancel all
lettactl cancel-messages my-agent