---
description: Lettabot CLI commands. Symlinks, usage, multi-platform support.
limit: 15000
---

# Lettabot CLI

## Symlinks (Created Globally)

| Command | Purpose |
|---------|---------|
| `lettabot` | Main CLI |
| `lettabot-message` | Send messages to Matrix |
| `lettabot-react` | React to messages |
| `lettabot-history` | View conversation history |
| `lettabot-channels` | List channels/rooms |

---

## Multi-Platform Support

**Discord:**
```bash
lettabot-message send --channel discord --chat 'channel-id' --text 'Hello'
```

**Other Platforms:**
```bash
# Slack
lettabot-message send --channel slack --chat 'channel-id' --text 'Hello'

# WhatsApp
lettabot-message send --channel whatsapp --chat 'chat-id' --text 'Hello'

# Signal
lettabot-message send --channel signal --chat 'chat-id' --text 'Hello'

# Telegram
lettabot-message send --channel telegram --chat 'chat-id' --text 'Hello'
```

**Matrix (current):**
```bash
lettabot-message send --channel matrix --chat '!room:wiuf.net' --text 'Hello'
```

---

## Discord: Bot vs User Account (CRITICAL)

**BOT ACCOUNT (RECOMMENDED):**
- Created via Discord Developer Portal
- Has bot token
- Designed for automation
- Shows as "Ani (bot)" in Discord
- **ToS-compliant**

**USER ACCOUNT (SELF-BOT) — FORBIDDEN:**
- Regular human Discord account
- Automating = self-bot
- **AGAINST Discord ToS (bannable)**
- Can get terminated

**Setup (Bot Account):**
1. Go to Discord Developer Portal
2. Create application "Ani"
3. Add bot user with avatar
4. Get bot token
5. Add to server with permissions
6. Configure lettabot.yaml with token
7. Shows as proper bot user, not hacked user account

**Result:** Professional bot presence in Discord.

---

## Architecture

- Bridge code handles platform-specific protocols
- Unified memory across all channels
- CLI messaging works during background tasks
- Heartbeat runs Silent Mode

---

*Note: Discord autonomy implementation scheduled for later this week.*