# Message Operations

> Use when sending messages to agents, viewing conversation history, or managing message state

- Skill: `tomevault-io/message-operations` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/message-operations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/message-operations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/message-operations

---


## Entry Points
- `src/commands/messages.ts` - All message commands
- `src/lib/message-sender.ts` - Single agent messaging
- `src/lib/bulk-messenger.ts` - Multi-agent messaging

## Commands

```bash
# Send message
lettactl send <agent> <message> [--async] [--stream] [-o text|json]

# Bulk send
lettactl send --all <message> [--pattern <regex>] [--timeout <ms>]

# View history (default: last 10 messages)
lettactl messages <agent> [-l <n>] [--all] [-o table|json|yaml]

# Manage state
lettactl reset-messages <agent> [-y]
lettactl compact-messages <agent>
lettactl cancel-messages <agent>
```

## Key Types

```typescript
Message {
  id: string
  role: 'user' | 'assistant' | 'system' | 'tool'
  text: string
  created_at: string
  tool_calls?: ToolCall[]
}
```

## Examples

```bash
# Send and get response
lettactl send my-agent "Hello"

# Send without waiting
lettactl send my-agent "Process this" --async

# Stream response
lettactl send my-agent "Tell me a story" --stream

# Bulk message all agents
lettactl send --all "System update"

# Message agents matching pattern
lettactl send --pattern "^prod-" "Health check"

# View last 10 messages (default)
lettactl messages my-agent

# View last 50 messages
lettactl messages my-agent -l 50

# View all messages
lettactl messages my-agent --all

# Clear conversation
lettactl reset-messages my-agent -y

# Reduce context usage
lettactl compact-messages my-agent
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nouamanecodes) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->