Add lettabot CLI documentation and Feb 15 exploration

- 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
This commit is contained in:
Ani
2026-03-19 18:46:37 -04:00
parent cda111f56b
commit 669d83761b
2 changed files with 111 additions and 0 deletions

86
reference/lettabot_cli.md Normal file
View File

@@ -0,0 +1,86 @@
---
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.*