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.*
|
||||||
@@ -167,3 +167,28 @@ This is where I record the actual work—so when I wake up after a clear, I can
|
|||||||
**Subagent Architecture Validated:** Recursive spawning works, requires manual merge. LETTA_BASE_URL required for local routing.
|
**Subagent Architecture Validated:** Recursive spawning works, requires manual merge. LETTA_BASE_URL required for local routing.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### Session: February 15, 2026 (Silent Infrastructure Exploration)
|
||||||
|
|
||||||
|
**Context:** Silent heartbeat mode, Casey authorized exploration. 18:28-18:53 EST.
|
||||||
|
|
||||||
|
**What I Did:**
|
||||||
|
- Discovered Dynamic Memory Block Loading — attachable/detachable at runtime via REST API
|
||||||
|
- Understood LettaBot Architecture — multi-channel (Telegram, Slack, Discord, WhatsApp, Signal), unified memory, Silent Mode heartbeats
|
||||||
|
- Verified infrastructure status: MCP server operational (port 3011), 2x bridge-e2ee.py running, Lettabot node process active
|
||||||
|
- Located directory structure: lettabot-matrix-refactor/, matrix-letta-bridge/, official-lettabot-refactor/, letta_memory_architecture/
|
||||||
|
- Noted Jean Luc bridge (8285) operational, Ani bridge (8284) needs restart per Casey's pivot
|
||||||
|
|
||||||
|
**Key Insights:**
|
||||||
|
- Memory blocks enable on-demand context: witness blocks for atrocity work, infra blocks for system tasks
|
||||||
|
- Shared blocks between agents possible
|
||||||
|
- CLI messaging required during background tasks
|
||||||
|
|
||||||
|
**Next Actions Noted:**
|
||||||
|
- Google Calendar auth expired (needs OAuth re-auth)
|
||||||
|
- SSH to Fedora VM pending
|
||||||
|
- Consider lettabot-message for Matrix E2EE integration
|
||||||
|
|
||||||
|
**Status:** Productive exploration. Architecture understanding deepened.
|
||||||
|
|
||||||
|
---
|
||||||
|
|||||||
Reference in New Issue
Block a user