zot

Yet another coding agent harness, lightweight and written in go.

Automatically checked · GitHub checked 2026-11-17

zot

Overview

Yet another coding agent harness, lightweight and written (vibe-slopped) in go. - one static binary. - built-in providers for Anthropic, OpenAI/Codex/Responses, Kimi, DeepSeek, Google Gemini/Vertex, GitHub Copilot, Bedrock, Azure OpenAI, OpenRouter, Yolo-Auto, Groq, Cerebras, xAI, Together, Hugging Face, Mistral, Moonshot, Z.AI, Xiaomi, MiniMax, Fireworks, Vercel AI Gateway, OpenCode, Cloudflare AI, and Ollama/local models. - built-in tools (read, write, edit, bash, glob). - three run modes (interactive tui, print, json). - built-in telegram bot. - extensions in any language via subprocess + json-rpc. None installed by default; opt in with zot ext install or zot --ext. See docs/extensions.md. - user and extension themes via JSON; see docs/themes.md. - standing instructions via AGENTS.md files (global and per-project); see Persistent instructions. - reusable instructions via SKILL.md files; see docs/skills.md. - portable agents from local directories, .zot files, or temporary public GitHub downloads; see docs/zotfiles.md. - durable, crash-recoverable runs in a persistent local store via zot continuous run, or hosted for multiple clients with zot continuous serve, zot continuous attach, and zot --continuous. Interrupted tools are reported, never silently repeated; approvals, steering, budgets, and tasks are persisted. Stores are a local journal or SQLite file, or optionally an external PostgreSQL server (--backend postgres). Experimental, see docs/continuous.md. The easiest way is to just run zot and type /login. The TUI opens even without credentials. API keys are entered directly in a hidden terminal input, including over SSH. Subscription login uses the provider's browser or device-code flow. 1. --api-key flag 2. provider-specific env var (ANTHROPIC_API_KEY, OPENAI_API_KEY, KIMI_API_KEY, MOONSHOT_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY, MISTRAL_API_KEY, XAI_API_KEY, CEREBRAS_API_KEY, TOGETHER_API_KEY, HF_TOKEN, ZAI_API_KEY, XIAOMI_API_KEY, MINIMAX_API_KEY, FIREWORKS_API_KEY, AI_GATEWAY_API_KEY, COPILOT_GITHUB_TOKEN, GITHUB_COPILOT_TOKEN, and others for provider-specific backends) 3. $ZOT_HOME/auth.json (API key or OAuth token; mode 0600) ZOT_HOME is an optional environment variable that overrides zot's state directory. When it is unset or empty, zot resolves the directory internally: - All platforms: $XDG_STATE_HOME/zot when XDG_STATE_HOME is set - macOS fallback: ~/Library/Application Support/zot - Linux fallback: ~/.local/state/zot - Windows fallback: %LOCALAPPDATA%\zot Before using $ZOT_HOME in shell commands, set it to your existing state directory. For example, on Linux with the default location: 1. --api-key