# zot

> zot is a lightweight, single-binary coding agent harness written in Go. It talks to Anthropic, OpenAI/Codex, Gemini/Vertex, Kimi, DeepSeek, Bedrock, Azure OpenAI, GitHub Copilot, OpenRouter, Ollama, and managed llama.cpp models, ships four built-in tools (read, write, edit, bash), three run modes plus RPC, extensions in any language over JSON-RPC, and a built-in Telegram bridge.

Install: `curl -fsSL https://www.zot.sh/install.sh | bash` (macOS/Linux) or `iwr -useb https://www.zot.sh/install.ps1 | iex` (Windows). Source: https://github.com/patriceckhart/zot

## Documentation

- [zot Documentation](https://www.zot.sh/docs): How to configure, run, and extend zot.
- [Quickstart](https://www.zot.sh/docs/quickstart): Install zot and run your first session.
- [Tools](https://www.zot.sh/docs/tools): The four built-in tools the agent uses.
- [Tool gate](https://www.zot.sh/docs/tool-gate): Confirm tool calls before they run.

## Models

- [Providers](https://www.zot.sh/docs/providers): Bring any model from any provider.
- [Models](https://www.zot.sh/docs/models): The merged model catalog and how to extend it.
- [Model fallback](https://www.zot.sh/docs/model-fallback): Recover from provider errors without losing your prompt.

## Working

- [Sessions](https://www.zot.sh/docs/sessions): Resume, fork, branch, compact, and export transcripts.
- [Side chat](https://www.zot.sh/docs/side-chat): Quick questions without bloating the main thread.
- [Swarm](https://www.zot.sh/docs/swarm): Background subagents running alongside your main session.
- [Jail mode](https://www.zot.sh/docs/jail): Confine the agent's tools to the current directory.
- [Settings](https://www.zot.sh/docs/settings): Every persistent setting, changeable mid-session.

## Customization

- [Extensions](https://www.zot.sh/docs/extensions): Extend zot in any language over JSON-RPC.
- [Skills](https://www.zot.sh/docs/skills): Per-folder SKILL.md instructions loaded on demand.
- [Instructions](https://www.zot.sh/docs/instructions): Project and global instructions loaded at startup.
- [Themes](https://www.zot.sh/docs/themes): Partial JSON themes for the TUI.
- [TUI settings](https://www.zot.sh/docs/tui-settings): Customize the input area and status placement.
- [System prompt](https://www.zot.sh/docs/system-prompt): Override or extend the built-in instructions.
- [zotfile agents](https://www.zot.sh/docs/zotfiles): Package agent behavior, skills, requirements, and permissions into a portable .zot file.

## Integrate

- [Embedding](https://www.zot.sh/docs/embedding): Drive zot from another program.
- [Node.js SDK](https://www.zot.sh/docs/node-sdk): Embed zot rpc in Node.js and TypeScript apps.
- [Swift bridge](https://www.zot.sh/docs/swift-bridge): Run the zot agent natively inside iOS and macOS apps.
- [Telegram](https://www.zot.sh/docs/telegram): DM zot from anywhere.
- [Messaging backends](https://www.zot.sh/docs/messaging-backends): The protocol-agnostic bot core behind Telegram and future transports.

## Extensions

- [Extension directory](https://www.zot.sh/extensions): Community extensions published on GitHub under the zot-extension or zot-ext topic.
- [patriceckhart/zot-review](https://www.zot.sh/extensions/patriceckhart/zot-review): Structured repo-wide code review for zot.
- [patriceckhart/zot-chrome-operator](https://www.zot.sh/extensions/patriceckhart/zot-chrome-operator): Chrome extension + local bridge for chatting with zot from a Chrome side panel and letting zot operate browser tabs through a `browser_action` tool.
- [vorons/zot-context7](https://www.zot.sh/extensions/vorons/zot-context7): zot extension that wraps the Context7 documentation API with a local SQLite cache.
- [vorons/zot-rtk](https://www.zot.sh/extensions/vorons/zot-rtk): Automatically routes bash commands through rtk.
- [patriceckhart/zot-answer](https://www.zot.sh/extensions/patriceckhart/zot-answer): A zot extension that opens /answer and lets you answer numbered questions from the last assistant message in an interactive panel.
- [patriceckhart/zot-goal](https://www.zot.sh/extensions/patriceckhart/zot-goal): A zot extension that implements "Run, Until, Goal Achieved".
- [terva-sh/zot-web](https://www.zot.sh/extensions/terva-sh/zot-web): web_search and web_fetch tools for zot-compatible coding agents
- [rgasper/zot-kagi-extension](https://www.zot.sh/extensions/rgasper/zot-kagi-extension): extension for kagi api usage in zot
- [patriceckhart/zot-loop](https://www.zot.sh/extensions/patriceckhart/zot-loop): Small automation helpers for zot: interval reminders, background command monitors, and a lightweight task list.
- [patriceckhart/zot-todo](https://www.zot.sh/extensions/patriceckhart/zot-todo): Interactive local todo dashboard for zot.
- [patriceckhart/zot-workspaces](https://www.zot.sh/extensions/patriceckhart/zot-workspaces): List every directory that has zot sessions mapped, and jump zot into one.
- [patriceckhart/zot-sidekick](https://www.zot.sh/extensions/patriceckhart/zot-sidekick): A macOS menu bar app that provides quick access to zot from anywhere on your system.
- [patriceckhart/zot-notifier](https://www.zot.sh/extensions/patriceckhart/zot-notifier): A small zot extension that plays a notification sound when the assistant finishes a turn.
- [patriceckhart/zot-followup](https://www.zot.sh/extensions/patriceckhart/zot-followup): A session-local follow-up queue for zot.

## Optional

- [Model catalog](https://www.zot.sh/model-catalog): Every model zot knows about across all providers.
- [Theme builder](https://www.zot.sh/themes): Build a zot TUI theme visually and export it as JSON.