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:
86
reference/lettabot_cli.md
Normal file
86
reference/lettabot_cli.md
Normal 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.*
|
||||
Reference in New Issue
Block a user