Files

Ani 669d83761b 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

2026-03-19 18:46:37 -04:00

1.9 KiB

Raw Blame History

description, limit

description	limit
Lettabot CLI commands. Symlinks, usage, multi-platform support.	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:

lettabot-message send --channel discord --chat 'channel-id' --text 'Hello'

Other Platforms:

# 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):

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):

Go to Discord Developer Portal
Create application "Ani"
Add bot user with avatar
Get bot token
Add to server with permissions
Configure lettabot.yaml with token
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.

1.9 KiB Raw Blame History