669d83761b
- reference/lettabot_cli.md: Symlinks, multi-platform support, Discord bot setup - subconscious/heartbeat_state.md: Added Feb 15 infrastructure exploration session Note: Discord autonomy implementation scheduled for later this week
87 lines
1.9 KiB
Markdown
87 lines
1.9 KiB
Markdown
---
|
|
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.*
|