Files

Cameron 7b6a730df2 docs: comprehensive documentation audit and improvements (#90 )

Fixes and updates:
- README.md: Remove duplicate heartbeat troubleshooting section
- docs/getting-started.md: Fix Node version (18→20), commands, repo URL
- docs/commands.md: Rewrite with accurate command list (/start, /status, /heartbeat)
- docs/README.md: New multi-channel architecture diagram
- docs/whatsapp-setup.md: Add selfChatMode safety docs, media support section
- docs/slack-setup.md: Fix broken links

New documentation:
- docs/configuration.md: Complete YAML config reference
- docs/cron-setup.md: Scheduling guide (cron jobs + heartbeats)

Written by Cameron ◯ Letta Code

"Documentation is a love letter that you write to your future self." - Damian Conway

2026-02-02 22:36:06 -08:00

1.8 KiB

Raw Blame History

Commands Reference

LettaBot responds to these slash commands in chat channels.

Available Commands

`/start` or `/help`

Shows the welcome message and list of available commands.

LettaBot - AI assistant with persistent memory

Commands:
/status - Show current status
/help - Show this message

Just send me a message to get started!

`/status`

Shows your current agent ID and connection status.

Useful for debugging or if you need to reference your agent in other tools.

Example:

You: /status
Bot: Agent: agent-a1b2c3d4-...
     Model: claude-sonnet-4
     Channels: telegram, slack

`/heartbeat`

Manually triggers a heartbeat check-in.

Heartbeats are background tasks where the agent can:

Review pending tasks
Check reminders
Perform proactive actions

Note: This command runs silently - the agent won't automatically reply. If the agent wants to message you during a heartbeat, it will use the lettabot-message CLI.

Sending Messages

Just type any message to chat with your agent. The agent has:

Persistent memory - Remembers your conversations over time
Tool access - Can search files, browse the web, and more
Streaming responses - You'll see the response appear in real-time

Tips:

Be specific in your requests
The agent remembers context, so you can refer back to previous conversations
For long tasks, the "typing..." indicator will stay active

Formatting

The bot supports markdown formatting in responses:

Bold text
Italic text
Inline code
Code blocks
Links

Note: Available formatting varies by channel. WhatsApp and Signal have limited markdown support.

Cross-Channel Commands

Commands work the same across all channels (Telegram, Slack, Discord, WhatsApp, Signal). The agent maintains a single conversation across all channels.

1.8 KiB Raw Blame History