Summary
zot is a coding agent harness shipped as one static Go binary with no runtime, no Docker and five built-in tools. It runs interactively, one-shot, as NDJSON, or as an RPC child process, and extends through subprocess extensions in any language.
- Best for
- Developers who want a fast, free, Go-native coding-agent harness with real session-branching control and are comfortable running fast-moving, self-described "beta forever" software from an independent maintainer.
- Not for
- Buyers who need a GUI (see Juggler), an enterprise support contract, or who are unwilling to accept the disclosed ToS risk of subscription-billing OAuth reuse and would rather stick to the API-key flow or a first-party vendor tool.
- From
- Free
- Free tier
- YesThe whole product is free: an MIT-licensed single binary installed by one command on macOS, Linux or Windows, with no accounts, quotas or feature gates. Your only cost is the model provider key or subscription you attach.
What it does
- Writes code
- YesThe built-in toolbox is read, write, edit, glob and bash, with write creating or overwriting files directly.
Five built-in tools. Zero ceremony. The minimum viable toolbox for an agent that actually ships code.
zot.sh/docs/tools - Debugs and fixes
- PartlyNo dedicated debugging feature; the vendor names failure investigation only as an example of a task you can hand a background sub-agent, which then edits the same working directory.
Spawn one for a side task (“draft the migration”, “investigate this stack trace”, “write the test harness for module X”), keep going in the main…
github.com/patriceckhart/zot - Writes tests
- PartlyTest authoring appears only as an example task for a swarm sub-agent; there is no test-generation feature in the tool set or the docs.
Spawn one for a side task (“draft the migration”, “investigate this stack trace”, “write the test harness for module X”), keep going in the main…
github.com/patriceckhart/zot - Reviews code
- PartlyReview is not in the binary: it comes from a separately installed extension by zot's own author, listed in the vendor's extension directory.
Structured repo-wide code review for zot.
zot.sh/extensions - Whole-codebase work
- PartlyRepo-wide reach is recursive glob plus bash; the documented tool set is five tools and none of them indexes a codebase.
Searches recursively, honors root and nested .gitignore rules, excludes hidden paths by default, and respects jail mode.
zot.sh/docs/tools - Ships it
- PartlyShipping is whatever the shell can do: bash runs commands in the session working directory. No deploy, pull-request or git-forge integration is documented.
Run a command in the session cwd with merged stdout/stderr and a timeout.
zot.sh/docs/tools
How much it does unattended
- Runs autonomously
- YesTools run without confirmation by default; the confirmation flag exists only in the TUI and is deliberately ignored in print, JSON and RPC modes.
In -p, --json, and rpc modes it is ignored with a stderr warning and tools still run freely, so scripts and automation keep working.
zot.sh/docs/tool-gate - Multi-agent
- Yes/swarm spawns background subagents, each its own subprocess and model loop; with auto-swarm on, the main agent can fork them itself via a swarm_spawn tool.
Each agent is a separate zot subprocess with its own model loop, its own persistent session file, and its own chat in the dashboard
zot.sh/docs/swarm - Agent permissions
- YesFree-running by default, with three brakes: --no-yolo confirms every call in the TUI, /jail confines tools to the working directory, and a zotfile manifest caps file and bash access.
Run with --no-yolo to confirm every tool call before it runs.
zot.sh/docs/tool-gate
Which models it runs on
- Claude
- YesClaude runs through an Anthropic API key, a Claude Pro/Max subscription login, or Bedrock and Vertex model IDs.
Anthropic Claude Pro/Max (anthropic), OpenAI Codex / ChatGPT Plus/Pro (openai-codex), Kimi Code (kimi), and GitHub Copilot (github-copilot).
zot.sh/docs/providers - GPT
- YesGPT and Codex models are baked into the catalog and reachable by OpenAI API key, a ChatGPT/Codex subscription login, or Azure OpenAI Responses.
Built-in entries cover Claude, GPT/Codex, Gemini/Gemma, Kimi/Moonshot, DeepSeek, Groq-hosted models, OpenRouter-routed models, Bedrock and Vertex…
zot.sh/docs/models - Open models
- YesOpen weights run locally through Ollama, an OpenAI-compatible endpoint, or a managed llama.cpp router with GGUF download, load and unload from /llama.
Managed GGUF models: connect the distinct llama.cpp provider to a recent llama.cpp router, then use /llama for download, load, unload, and removal.
zot.sh/docs/providers - Model choice
- YesYou pick: one merged catalog across every configured provider, switchable mid-session with /model or Ctrl+1..9, and extendable with your own models.json entries.
--list-models and /model show the merged catalog across every provider.
zot.sh/docs/models
Where you use it
- In your editor
- NoA terminal agent. The documented run modes are the TUI, print, JSON and an RPC child process; no editor or IDE plugin is offered.
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.
zot.sh/docs - On the command line
- YesThe CLI is the product: an interactive TUI plus a one-shot print mode that reads piped stdin and writes final text to stdout.
print — zot -p, one-shot, final assistant text to stdout. Great for shell pipelines.
zot.sh/docs - In your pipeline
- PartlyJSON mode is pitched at CI and emits NDJSON events, but no pull-request, GitHub Action or forge integration is documented; you wire the binary in yourself.
json — zot --json, NDJSON events to stdout. Perfect for scripts and CI.
zot.sh/docs - In a browser
- NoNo hosted web app. The only remote surface documented is a Telegram DM bridge over a protocol-agnostic bot core.
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.
zot.sh/docs
Whose machine it runs on
- Self-hosted
- YesSelf-hosting is the only mode: a static binary on your machine, using your credentials, in your working directory. There is no vendor-run backend.
The user runs it locally with their own model credentials, in their own workspace, using zot as the runtime.
zot.sh/docs/zotfiles - Open source
- YesOpen source, and the footer of every page states it is MIT licensed and built in Go; source and docs are published on GitHub.
This website provides information about zot, an open-source coding agent harness.
zot.sh/disclaimer
What it costs to run
- How it meters
- YesNothing is metered by zot: the binary is free and every token is billed to the API key or subscription you attach with /login.
Use /login to store an API key or a subscription credential.
zot.sh/docs/quickstart - Free tier
- YesOne install command on macOS, Linux or Windows, or go install from source. No account with the vendor exists to sign up for.
One command on macOS, Linux, or Windows.
zot.sh - API access
- YesThree ways in: a Go in-process SDK, zot rpc speaking NDJSON over stdin/stdout, and a packaged Node.js TypeScript client plus a Swift xcframework.
Spawn zot rpc as a subprocess and exchange NDJSON over its stdin/stdout. Reference clients for Python, Node, shell, and Go live under examples/rpc/.
zot.sh/docs/embedding - MCP server
- PartlyMCP is deliberately not built in; an extension proxies configured MCP servers into zot. Nothing documents zot serving MCP to another agent; that path is the RPC protocol.
Build CLI tools with skills, or add an extension that speaks MCP if you actually need it.
zot.sh - Bring your own key
- YesBring your own everything: provider API keys, existing Claude/ChatGPT/Kimi/Copilot subscriptions, keys fetched from a password manager, or your own AWS, Azure, Vertex or local endpoint.
zot supports Claude Pro/Max, ChatGPT/Codex, Kimi Code, and GitHub Copilot subscriptions, plus direct API keys for every provider in the catalog.
zot.sh/docs/quickstart
Buying it for a team
- Admin controls
- PartlyConstraints are per-machine, not centrally administered: a zotfile manifest caps file and bash access, and jail_by_default in config.json starts every run confined to the working directory.
zotfile permissions are an enforced ceiling for the built-in file and bash tools. Empty or omitted filesystem scopes deny access.
zot.sh/docs/zotfiles - Audit log
- PartlyEvery session keeps a full local JSONL transcript, inspectable as a timeline and exportable as JSON, but it is a user-owned transcript rather than an administrative audit trail.
Every turn is appended to a JSONL transcript under $ZOT_HOME.
zot.sh/docs/sessions - Single sign-on
- NoAuthentication is provider credentials only: subscription OAuth or API keys. No SAML or OIDC for zot itself.
Use /login for subscription auth and simple API-key providers.
zot.sh/docs/providers
What happens to your code
- Data residency
- PartlyYou choose the jurisdiction with the provider: Bedrock runs against the AWS_REGION you set and some models need us. or eu. regional inference-profile IDs.
Some Bedrock models require regional inference-profile IDs for on-demand throughput, such as us. or eu. prefixed model IDs.
zot.sh/docs/providers - Getting out
- YesTranscripts are plain JSONL files you own, /session export writes a portable .zotsession and the timeline exports to JSON; swarm subagent state does not round-trip. No credits exist to expire.
/session export writes the transcript to a portable .zotsession file. /session import pulls one back in as a first-class resumable session.
zot.sh/docs/sessions
Not established: Opt out of training, Certifications
29 sourced claims on this page. Checked 2026-09-03. How we check.
Alternatives
Where we would send a reader instead, in that listing's own words.
Open-source desktop workbench for AI coding agents, with inspectable tool calls and branching threads.
Open source AI coding agent for the terminal, desktop, browser and IDE, running any model you connect.
Open-source terminal AI coding tool that edits your local git repo and commits the changes.
Filed under
Sources and updates
The pages we read20
1 of 20 independent of the vendor.
- zot.sh/docs/providers8 fields
- zot.sh/docs4 fields
- github.com/patriceckhart/zot4 fields
- zot.sh/3 fields
- zot.sh/docs/models3 fields
- zot.sh/docs/sessions3 fields
- zot.sh/docs/tools3 fields
- zot.sh/2 fields
- zot.sh/docs/quickstart2 fields
- zot.sh/docs/tool-gate2 fields
- zot.sh/docs/zotfiles2 fields
- github.com/patriceckhart/zot/blob/main/LICENSE2 fields
- zot.sh/disclaimer1 field
- zot.sh/docs/embedding1 field
- zot.sh/docs/instructions1 field
- zot.sh/docs/node-sdk1 field
- zot.sh/docs/swarm1 field
- zot.sh/extensions1 field
- zot.sh/extensions/patriceckhart/zot-review1 field
- api.github.com/repos/patriceckhart/zotPlatform record1 field
Platform record2026-08-30
- Licence
- MIT
- Stars
- 328
- Forks
- 34
- Last push
- 2026-08-27
Updates3
- Capabilities · Commercial terms · Free tier
- Capabilities · Commercial terms · Free tier
- Alternatives · One-liner · Summary
