Files
lettabot/docs/commands.md
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

74 lines
1.8 KiB
Markdown

# 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](https://example.com)
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.