zot Documentation

How to configure, run, and extend zot.

Docs on GitHub

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.

Next steps

  • Install and run your first session in the Quickstart.
  • Learn the four built-in Tools the agent uses.
  • Wire up a provider in Providers.