Run tota for the first time. The onboarding wizard asks for:

  • Your name — used by the agent to address you
  • Agent name — defaults to "tota", customize it
  • LLM providers — choose one or more: DeepSeek, OpenAI, Anthropic, Grok, Ollama Cloud, Ollama Local, or OpenAI Compatible
  • Model selection — after each valid key, tota fetches recommended chat models and lets you choose a default
  • Telegram bot token — optional, for remote access in private 1:1 chats

Provider keys are validated by format and then by fetching available models. If model discovery fails, tota asks you to re-enter the key instead of accepting random text.

If you enable Telegram during first-time setup, tota starts a temporary pairing flow: send /start to your bot in Telegram, copy the pairing code you receive there, then paste that code into the CLI to finish setup.

All config is stored in ~/.tota/ — nothing in your project directory.

ℹ️

Masked keys — When reconfiguring with tota doctor, existing API keys are shown masked like sk-x••••4f2a. Press Enter to keep the current value, or paste a new key to replace it.