llms.txt
Compare with other sites' llms.txt files →# Empryo
> Empryo is an AI coding harness that edits symbols, not strings. When it opens your repo it builds the Genome, a map of every function, type, caller and import, and the agent starts each task from that map. It edits code by symbol name and uses your language server for renames, instead of find and replace. It works with many model providers, lets you pick a different model for different jobs, and can roll back to earlier checkpoints. It runs as a desktop app, a terminal UI and a headless CLI on macOS, Linux and Windows. Bring your own model key or run local models.
Every docs and blog URL below also serves a raw-markdown mirror at the same path + `.md` (e.g. https://empryo.com/docs/quickstart.md), and via `Accept: text/markdown` on the HTML path. The full corpus in one file: https://empryo.com/llms-full.txt. Machine-readable discovery manifest: https://empryo.com/agent-manifest.json. API catalog: https://empryo.com/.well-known/api-catalog. Retrieval skill index (draft discovery v0.2.0): https://empryo.com/.well-known/agent-skills/index.json. Public API description: https://empryo.com/openapi.json
## When to use Empryo
Reach for Empryo when the job is working on a real codebase with an AI agent:
- Multi-file refactors, renames and bug fixes that must not break other call sites. Empryo edits by symbol name and uses the language server for renames, instead of find and replace.
- Understanding an unfamiliar repo. On launch it builds the Genome, a map of the codebase, and can tell you which files and callers a change would affect.
- Scripts and CI. It runs headless: `empryo --headless "<prompt>" --json` for structured output, `--events` for a JSONL event stream, `--loop "<goal>"` for a coder and reviewer loop that reports the verdict as an exit code (0 pass, 3 fail).
- Controlling cost. You can assign a different model to each kind of job, so cheap tasks go to cheaper models, all on your own API keys.
Not the right tool for: hosted/serverless code review (Empryo runs locally against a checkout), or plain-text chat without a repository.
How an agent should use this site: start from this file; fetch any docs/blog page as markdown (same URL + `.md`); read https://empryo.com/llms-full.txt for the whole corpus in one request; query https://empryo.com/api/version for the current release. Install: `curl -fsSL empryo.com/install.sh | bash` (macOS/Linux) or `irm https://empryo.com/install.ps1 | iex` (Windows).
## Start here
- [Home](https://empryo.com/): overview
- [Features](https://empryo.com/features): what Empryo does
- [Download](https://empryo.com/download): install in 60 seconds
- [Changelog](https://empryo.com/changelog): every release, newest first
## Benchmarks
- [Benchmarks](https://empryo.com/benchmarks): console-verified head-to-heads — each agent on its own API key, the provider's bill is the judge
- [Empryo vs pi — Round 1](https://empryo.com/benchmarks/pi-round-1): hookboard project, 8/9 vs 7/9 fixed, −28% billed cost
- [Empryo vs pi — Round 2](https://empryo.com/benchmarks/pi-round-2): five real bugs from hono, zod and ky — 7/10 vs 6/10, −23% billed cost, contamination-proof harness
- [Independent benchmark by important.is](https://empryo.com/benchmarks/important-is): 113 runs, GLM 5.3 −51% input tokens vs Claude Code (19/19 vs 17/19), Kimi −47% vs kimi CLI, GPT-6.1 −17% vs Codex CLI
- [Harness + raw results](https://github.com/proxysoul/empryo-bench): reproducible with two API keys and one command
## Docs
Section-level index (one exact section instead of a whole page): https://empryo.com/api/docs/sections · search: https://empryo.com/api/docs/search?q=<terms>[&scope=morphs] · Cells (desktop extensions) task map: https://empryo.com/docs/tools/morphs/llms.txt · Cell JSON Schema: https://empryo.com/morphs.schema.json
- [Child tabs](https://empryo.com/docs/agents/child-tabs.md): A tab can open tabs that stay attached and nested under it on every surface. A tab an agent opened closes on its own after it answers unless you keep it; agents close only themselves or tabs under them, and you can detach any.
- [Tabs](https://empryo.com/docs/agents/cross-tab.md): Run many agents side by side in one project. Tabs warn each other before editing the same file, and git won't commit another tab's half-written work.
- [Parallel subagents](https://empryo.com/docs/agents/dispatch.md): Split one task across subagents that run side by side, each on the model its job needs. Follow them live, steer them, or connect them in a workflow.
- [Docs for agents](https://empryo.com/docs/agents/docs-mcp.md): Give any AI agent Empryo's docs: copy a page as Markdown or plain text, connect the read-only docs MCP server, or use the empryo skill that ships with the app.
- [The goal loop](https://empryo.com/docs/agents/goal-loop.md): State a goal and Empryo keeps working in rounds, with a fresh reviewer checking each one, until the goal passes, the loop gets stuck, or it hits a limit.
- [The reviewer](https://empryo.com/docs/agents/review.md): A separate agent with a clean context reads what changed and returns PASS, FAIL or PARTIAL. Run it on demand, loop it until it passes, or use it in CI.
- [Steering](https://empryo.com/docs/agents/steering.md): Change what the agent is doing while it works, just by typing. Your message is added at its next step, so you never have to stop it and start over.
- [Multi-agent workflows](https://empryo.com/docs/agents/workflows.md): Connect specialist agents in workflows with separate models, parallel reviews, arbitration and bounded retries. Inspect the graph and follow every run.
- [How it works](https://empryo.com/docs/concepts/architecture.md): A plain mental model of Empryo: the apps you use, the agent and its helpers, the tools it calls, the Genome map of your code, and memory across sessions.
- [Compound tools](https://empryo.com/docs/concepts/compound-tools.md): Tools that finish a whole job in one call: rename a symbol everywhere, move code between files, run your tests, or refactor, with the result checked afterwards.
- [Cost tracking](https://empryo.com/docs/concepts/cost-tracking.md): See what every session costs in dollars as you work, broken down by model and helper agent, plus live allowance meters for subscription and credit plans.
- [The Genome](https://empryo.com/docs/concepts/genome.md): The Genome is Empryo's live, ranked map of your repository. It goes into every prompt so the agent knows where code lives before it starts searching.
- [Code intelligence](https://empryo.com/docs/concepts/intelligence.md): How the agent finds definitions, references and type errors with your language servers, falls back to parsing when none is available, and checks every edit.
- [The Marionette](https://empryo.com/docs/concepts/marionette.md): An optional quick pass before each prompt: a cheap model finds the files and line ranges your request is about and attaches that map for the main agent.
- [Model events](https://empryo.com/docs/concepts/model-events.md): An opt-in debug view that records each model call's speed, token count and errors, so you can find the slow or failing model when you mix providers.
- [Context compaction](https://empryo.com/docs/context/compaction.md): Long sessions never hit the wall. Empryo folds older work into a compact summary in about a second and keeps every file and decision.
- [Prompt cache and ping](https://empryo.com/docs/context/prompt-cache.md): See how long the prompt cache lasts on desktop, in the terminal and on the phone, keep a lane warm while idle, and find out why a cache broke.
- [Modes & the prompt](https://empryo.com/docs/context/prompt-system.md): Switch how the agent works with Ctrl+D, give it project rules in EMPRYO.md, and reuse instruction files you already wrote for Claude Code, Cursor and others.
- [Thinking, effort & retries](https://empryo.com/docs/context/provider-options.md): Control how much the model thinks before answering, set reasoning effort per model or provider, and tune retries when a provider is rate-limiting you.
- [Provider tools](https://empryo.com/docs/context/provider-tools.md): Computer use, code execution, the Anthropic text editor and provider-side search: what each does, which models support it, and how to switch it on or off.
- [FAQ](https://empryo.com/docs/faq.md): Answers about Windows support, API keys and local models, costs, how Empryo edits code, privacy, sessions, and language coverage.
- [Empryo](https://empryo.com/docs/index.md): Empryo is an AI coding agent for the desktop, terminal, and scripts. It keeps a live map of your codebase, so its edits are informed.
- [Installation](https://empryo.com/docs/installation.md): Install Empryo on macOS, Linux, or Windows x64 with the official command-line installer or the desktop app, then check the install and connect a model.
- [GitHub Copilot](https://empryo.com/docs/providers/copilot.md): Use your paid GitHub Copilot subscription in Empryo: sign in with a device code, watch the monthly allowance, run Claude, GPT and Gemini at no extra cost.
- [Custom providers](https://empryo.com/docs/providers/custom.md): Connect any OpenAI-compatible API to Empryo with one config block: set baseURL, key env var, models, dynamic model lists, and reasoning options.
- [Providers](https://empryo.com/docs/providers/overview.md): Connect Empryo to a model: save an API key, sign in with a subscription you already pay for, or run a local model. Many providers are supported.
- [Proxy](https://empryo.com/docs/providers/proxy.md): Use Claude, ChatGPT, Gemini and Grok subscriptions through the optional proxy add-on, and read the plan limits and reset times it reports.
- [Subscriptions](https://empryo.com/docs/providers/subscriptions.md): Sign in to ChatGPT, Copilot, Cursor, Devin, Gemini, Grok, Kimi and more from Empryo with no add-on. One /login picker, credentials in your keychain.
- [Quickstart](https://empryo.com/docs/quickstart.md): Go from install to your first reviewed change in about five minutes: connect a model, open a project, ask a question, and check the diff.
- [Run from CI or scripts](https://empryo.com/docs/recipes/headless.md): Run Empryo without the UI in scripts and CI: pipe in a prompt, get JSON or live events, resume sessions, and fail a pipeline on a review verdict.
- [Model fallback chains](https://empryo.com/docs/recipes/model-fallback.md): Give each model a list of backups so Empryo switches to another model when a provider is overloaded, rate-limited, or timing out, and your session keeps going.
- [Plan before you code](https://empryo.com/docs/recipes/plan-mode.md): Use Empryo's plan mode for changes across many files: the agent researches first, writes a plan for you to review, and waits for your approval before editing.
- [Rename & refactor](https://empryo.com/docs/recipes/rename-refactor.md): Rename a symbol in every file, move symbols and files without breaking imports, extract functions, and clean up imports, all by asking Empryo in plain words.
- [Use multiple models](https://empryo.com/docs/recipes/task-router.md): Choose models and reasoning effort for research, coding, reviews and multi-agent workflows. Set defaults for each job or give specialists their own models.
- [Test, lint, commit](https://empryo.com/docs/recipes/test-and-commit.md): Ask Empryo to run your tests, linter, and type checker with the right commands for your project, fix what fails, and commit the result with a clear message.
- [CLI reference](https://empryo.com/docs/reference/cli.md): Every empryo command-line flag, subcommand, exit code, and environment variable, for the terminal app and for headless runs in scripts and CI.
- [Command reference](https://empryo.com/docs/reference/commands.md): Every Empryo slash command and keyboard shortcut on one page, grouped by session, git, models, code intelligence, settings, editor, tabs, and system.
- [Configuration](https://empryo.com/docs/reference/configuration.md): Every Empryo setting: default model, thinking, the Genome code index, task router, agent features, key storage, instruction files, and environment variables.
- [Presets](https://empryo.com/docs/reference/presets.md): Load shareable Empryo settings bundles by name, file path, or URL to keep your router, agent features, theme, and providers the same across machines and teams.
- [Tools](https://empryo.com/docs/reference/tools.md): Every tool the Empryo agent can use: what each one does, which app or mode it needs, which tools are always on, and how to turn the others off.
- [Sponsors & Backers](https://empryo.com/docs/sponsors.md): The people and companies who fund Empryo, an AI coding agent, plus GitHub Sponsors tiers from $5 to $1,000 a month and one-time options.
- [ACP editors](https://empryo.com/docs/surfaces/acp.md): Run Empryo as an ACP agent in Zed, T3 Code and other editors: setup, models, permissions, sessions, file access and protocol limits.
- [Desktop app](https://empryo.com/docs/surfaces/desktop.md): The Empryo desktop app: tabs, a visual map of your codebase, a file preview with code intelligence, visual diffs, terminals, and a browser the agent can drive.
- [Another computer](https://empryo.com/docs/surfaces/devices.md): Use the Empryo on another computer from the one you sit at. Pair once, then open its projects here. Chats, tools and files stay on that computer.
- [Headless & output formats](https://empryo.com/docs/surfaces/headless.md): Run Empryo from scripts and CI with empryo --headless: plain, JSON, and JSONL event output, multi-turn chat over stdin, and exit codes.
- [Surfaces](https://empryo.com/docs/surfaces/overview.md): Use Empryo from the terminal UI, the desktop app, the phone app or the headless CLI. All of them run the same agent with the same tools, sessions and settings.
- [Phone app](https://empryo.com/docs/surfaces/phone.md): Drive the chats on your computer from your phone, tablet or watch: iPhone, iPad, Apple Watch and Android. Pair with /remote and get told when a turn is done.
- [Terminal UI](https://empryo.com/docs/surfaces/tui.md): Use Empryo in your terminal: the start menu, shortcuts, the prompt box, modes, tabs, panels, the status bar, mouse support and the embedded Neovim editor.
- [Voice input](https://empryo.com/docs/surfaces/voice-input.md): Speak prompts in the terminal UI, desktop app, phone and CLI. Transcribe on your ChatGPT plan, live with gpt-live-transcribe, or offline with whisper.cpp.
- [The workbench](https://empryo.com/docs/surfaces/workbench.md): Find runs, jobs, agent conversations and routines in the terminal workbench. Explore the desktop destinations for code, changes, tools, costs and settings.
- [Learn Empryo in the terminal](https://empryo.com/docs/terminal-guide.md): Twenty-three short demos of the real Empryo terminal. Press the keys yourself: sign-in, the router, subagents, workflows, the Genome, computer use and more.
- [Addons](https://empryo.com/docs/tools/addons.md): Install Empryo's optional addons from the command line: a local proxy for chat subscriptions, and a bundled Neovim for the editor panel.
- [Agents](https://empryo.com/docs/tools/agents.md): Define your own specialist subagents as markdown files. Empryo also reads the agent folders you already have for Claude Code, opencode and Gemini CLI.
- [AST editing](https://empryo.com/docs/tools/ast-edit.md): How Empryo edits TypeScript and JavaScript by symbol name instead of by matching text, so edits don't fail on whitespace or drift with line numbers.
- [The browser](https://empryo.com/docs/tools/browser.md): Let the agent open, click through and check the app you build: a browser panel on desktop, a headless browser in the terminal. Local addresses only by default.
- [Checkpoints](https://empryo.com/docs/tools/checkpoints.md): Undo, redo and rewind agent work, or edit, rewind and resend any prompt. Step back through past turns and restore files and the conversation.
- [Computer use](https://empryo.com/docs/tools/computer-use.md): Let the agent use real interfaces: Empryo's browser, your Chrome, other app windows or the whole screen, with per-capability permissions and a stop button.
- [Editor & Neovim](https://empryo.com/docs/tools/editor.md): A real Neovim inside Empryo's terminal UI with your config, plugins and language servers. The agent reads, edits and navigates code in the same editor.
- [Hooks](https://empryo.com/docs/tools/hooks.md): Run your own shell commands when the agent uses a tool, starts or ends a session, or compacts. Works with Claude Code hooks and reads Copilot and Codex hooks.
- [Interactive answers](https://empryo.com/docs/tools/interactive-answers.md): Empryo can answer with something you can use: a quick card of numbers, sliders and buttons, or a live React view with charts and animation, in the chat or in a canvas beside it.
- [Languages](https://empryo.com/docs/tools/languages.md): Use Empryo in English, Arabic, French, Korean, Russian or Simplified Chinese. Switch live, get a mirrored desktop layout for Arabic, and see numbers and dates in your locale.
- [Logs, errors and worker effort](https://empryo.com/docs/tools/logs.md): Where Empryo shows errors, model calls and compactions, what the reasoning effort next to each worker's model means, and where the error log file lives.
- [LSP servers](https://empryo.com/docs/tools/lsp.md): Language servers give Empryo exact definitions, references and errors for your code. Empryo installs them for you, and /lsp lets you manage them in the TUI.
- [MCP Servers](https://empryo.com/docs/tools/mcp.md): Connect Empryo to Model Context Protocol (MCP) servers over stdio, HTTP or SSE, so the agent can use their tools next to the built-in ones.
- [Memory](https://empryo.com/docs/tools/memory.md): Empryo remembers your preferences, project decisions and past gotchas across sessions, and adds up to 3 relevant ones to each turn automatically.
- [Cells & Morphs (experimental)](https://empryo.com/docs/tools/morphs.md): Change the Empryo desktop app with one JSON file: panels for notes, boards and timers, status chips, commands, shortcuts and agent rules. No code needed.
- [Profiles](https://empryo.com/docs/tools/profiles.md): Save a whole way of working as a profile: model, mode, instructions, tools, skills and model routing. Pick it for a tab in one click, turn it off the same way.
- [Project tool](https://empryo.com/docs/tools/project.md): The project tool reads your config files, runs the right lint, typecheck, test, build and format commands in 23 ecosystems, and checks code before commits.
- [Pull requests](https://empryo.com/docs/tools/pull-requests.md): Follow the GitHub pull requests each tab opens, pushes to or reviews: live checks, reviews and merge state, and merge, close or comment without leaving Empryo.
- [Python kernel](https://empryo.com/docs/tools/python-kernel.md): Give the agent a Python interpreter that stays running between calls, so loaded data, variables and imports are still there on the next step. Off by default.
- [Routines](https://empryo.com/docs/tools/routines.md): Schedule agent runs for a repository with /schedule: a nightly review, an hourly check, a daily summary. They run while Empryo is open, with no service.
- [Sessions](https://empryo.com/docs/tools/sessions.md): Empryo saves every conversation as you go. Resume a session by id, export it as markdown or JSON, or move it to another machine with its checkpoints.
- [Duck, advisor, council and namer](https://empryo.com/docs/tools/side-agents.md): Helpers beside the coding agent: a duck to think out loud with, an advisor for a second opinion, a council that debates a decision, and the tab namer.
- [Skills](https://empryo.com/docs/tools/skills.md): Teach Empryo's agent a framework, workflow or style guide with a SKILL.md file. Browse skills.sh, install per project or everywhere, toggle per session.
- [Floating Terminals](https://empryo.com/docs/tools/terminals.md): Open up to 5 terminals inside the Empryo desktop app to r