| Command | Description |
|---|---|
tota ui | Open the local web UI at http://127.0.0.1:3001 |
tota ui --port <n> | Use a custom port for the web UI |
tota ui --no-open | Start the UI server without opening the browser |
tota ui --attach | Attach the web UI to an already-running tota API instance |
tota up | Recommended. Start tota as a persistent daemon — installs the system service if needed, shows PID if already running |
tota | Start the agent (same as tota start) |
tota start | Start as background daemon (default) |
tota start --foreground | Start in foreground (interactive) mode. Shorthand: -f |
tota start --detached | Run in background (daemon mode) — same as default. Shorthand: -d |
tota restart | Restart a background tota process |
tota stop | Stop a background tota process |
tota logs | Show last 100 lines of daemon logs |
tota logs -f | Live-follow daemon logs (Ctrl+C to stop) |
tota logs -n <n> | Show last N lines of daemon logs |
tota logs --clear | Clear the daemon log file |
tota status | Show config, providers, daemon PID, and budget |
tota doctor | Reconfigure all settings — press Enter to keep current values |
tota doctor <feature> | Reconfigure one section only |
tota setup | Re-run the full setup wizard |
tota setup <feature> | Configure one section only (see below) |
tota help | Show the full manual (tools, commands, config paths) |
tota upgrade | Upgrade tota to the latest version from npm |
tota service install | Install as system service (auto-start on boot) |
tota service uninstall | Uninstall the system service |
tota service status | Show system service status |
tota --verbose | Start with debug logging on stderr |
#Telegram Access Management
| Command | Description |
|---|---|
tota telegram list | List approved users and pending requests |
tota telegram approve <code|id> | Approve a pairing code or pending request |
tota telegram reject <id> | Reject a pending request |
tota telegram remove <id> | Remove an approved user |
tota telegram promote <id> | Promote member to admin |
tota telegram demote <id> | Demote admin to member |
tota telegram unpair | Reset all Telegram access |
#WhatsApp Access Management
| Command | Description |
|---|---|
tota whatsapp status | Show linked state, approved and pending numbers |
tota whatsapp setup | Run the WhatsApp setup wizard |
tota whatsapp link | Display QR code to link your WhatsApp device |
tota whatsapp allow <phone> | Add a phone to the allowed list (E.164 format) |
tota whatsapp disallow <phone> | Remove a phone from the allowed list |
tota whatsapp pending | List pending access requests |
tota whatsapp approve <phone> | Approve a pending access request |
tota whatsapp reject <phone> | Reject a pending access request |
tota whatsapp remove <phone> | Remove a number from access |
tota whatsapp revoke | Revoke the WhatsApp session — deletes saved auth and disconnects the linked device |
#tota setup <feature> — Configure a Single Section
You don’t have to run the full wizard just to change one thing. Pass a feature name to update only that section. The agent keeps running — open a new terminal tab or split your terminal.
| Feature | What it configures |
|---|---|
identity | Your name and agent name |
llm | LLM providers and models |
telegram | Telegram bot token and pairing |
whatsapp | WhatsApp channel (QR link, allowed numbers, auth directory) |
github | GitHub username, PAT, default repo |
websearch | Web search provider key (Brave / Serper / Tavily) |
browser | Install Chromium browser binary (Playwright) |
computer | Enable / disable computer-use and Android ADB tools |
calendar | Google Calendar OAuth2 credentials |
voice | TTS/STT providers (OpenAI / ElevenLabs / Google / Groq) |
vault | Show secrets vault backend and usage info |
api | REST API channel (port, auth key) |
budget | Daily token budget |
tota setup websearch # add or change your web search key
tota setup llm # swap or add a provider
tota setup telegram # update your Telegram bot token
tota setup whatsapp # enable / configure WhatsApp channel
tota setup browser # install Chromium for browser automation
tota setup computer # enable / disable computer-use & Android ADB
tota setup calendar # configure Google Calendar credentials
tota setup voice # configure TTS/STT providers
tota setup vault # view secrets vault backend info
tota setup api # enable / configure the REST API channel
tota setup budget # change your daily token limit
tota doctor <feature> is an alias for the same thing.
#In the / Menu
While chatting, open the / command picker and choose Configure. Select the feature you want — tota prints the exact command to run in a new terminal. The running session is not interrupted.