zot Documentation

zot is a lightweight terminal coding agent, shipped as one static Go binary. No runtime. No Docker. No plugin system with a dedicated package manager. Just the agent loop done well.

It talks to Anthropic, OpenAI/Codex, Gemini/Vertex, Kimi, DeepSeek, Bedrock, Azure OpenAI, GitHub Copilot, OpenRouter, and many more, edits your files, runs your shell, and can even answer your Telegram DMs.

Run modes

• interactive — full TUI with streaming output, slash commands, queued messages, and an inline side-chat.
• print — zot -p, one-shot, final assistant text to stdout. Great for shell pipelines.
• json — zot --json, NDJSON events to stdout. Perfect for scripts and CI.
• rpc — zot rpc, a long-lived child process exchanging NDJSON over stdin/stdout. Drop zot into apps written in any language.

zot continuous adds experimental persistent execution: run a recoverable conversation locally, or keep a host running and attach CLI, TUI, or browser clients without tying work to a terminal. Conversations can switch providers and models while preserving history and keep editable titles alongside their stable IDs. The browser client also nests subagents under their owning conversations. Continuous execution uses a file journal, SQLite, or an explicitly configured PostgreSQL store rather than ordinary session files. PostgreSQL setup includes Neon connection routing and explicit remote-durability trust settings. See Continuous execution for setup, recovery, backups, and repository-scoped workers.

Next steps

• Install and run your first session in the Quickstart.
• Learn the five default Tools the agent uses.
• Orchestrate tools with JavaScript using optional Codemode.
• Connect local and remote MCP servers without installing a bridge.
• Wire up a provider in Providers.