# OpenAgents > OpenAgents is an open network of agents you work with through one conversation, from anywhere: this website, your phone, or a terminal. Coder, its coding agent, works on your own computer with the coding agents you already use. Developers can call our models through the OpenAgents API. Every page here is also Markdown: add `.md` to its address, or send `Accept: text/markdown`. ## Getting started What OpenAgents is, your first task with Coder, and how to get it. - [What is OpenAgents](https://openagents.com/docs/what-is-openagents.md): OpenAgents is an open network of agents you work with through one conversation, from anywhere: this website, your phone, or a terminal. Ask a question, plan some work, or ask for a code change, and… - [Start here](https://openagents.com/docs/start-here.md): Your first half hour with Coder, step by step: install it, log in, give it a first task in one of your repositories, read what it did, and answer a step that waits for you. Every command is here to… - [Download and install](https://openagents.com/docs/download.md): Coder runs on macOS, Linux, and Windows. One command installs it, and the same command updates it. The download page has the same commands and a manual download for each platform. ## Apps The website, the phone and desktop apps, custom agents, the Terminal, and the command. - [Chat on openagents.com](https://openagents.com/docs/website.md): The new chat page has a message box. Type what you want to ask and send it. The site opens a new chat at an address under /chat/. - [OpenAgents desktop app](https://openagents.com/docs/mac.md): The OpenAgents desktop app, for Mac, Linux, and Windows, is coming soon. It isn't published for download yet. When it is, it shows on the download page. - [OpenAgents for iPhone](https://openagents.com/docs/iphone.md): OpenAgents for iPhone is the OpenAgents app on your phone. Ask anything, start coding work that runs in our cloud, and connect your own computer when you want to. You don't need a computer or an… - [Custom agents](https://openagents.com/docs/custom-agents.md): A custom agent is an agent you define: a name, a description, instructions, and the coding agent it runs on, such as Claude Code or Codex, with an optional model. You save it to your account, and… - [OpenAgents Terminal](https://openagents.com/docs/terminal.md): OpenAgents Terminal is a full-screen chat with OpenAgents in your terminal. When a message is coding work, Coder runs on this computer, in the folder you started from, and its steps stream into the… - [The openagents command](https://openagents.com/docs/cli.md): openagents is the command-line program that comes with Coder. Use it to run Coder from a script, chat from a script, change settings, work with plugins, and connect phones to a computer without a… ## Chat What the chat answers, and who sees your messages. - [Chat](https://openagents.com/docs/chat.md): Chat is where you talk with OpenAgents. It's the same chat on the website, the iPhone app, and the Terminal. OpenAgents answers as "we". - [Privacy and security](https://openagents.com/docs/privacy-and-security.md): No account needed. The apps have no account or password. Your phone or computer makes its own key the first time it runs and signs every message with it. On the website, the site signs your messages… ## Coder Coding work on your own computer, with the agents you already use. - [Coder quick start](https://openagents.com/docs/coder.md): Coder is a coding agent in your terminal. Run coder in a project folder and ask in plain words: explain this code, fix that test, add a feature. It reads, edits, and runs commands in that folder, and… - [How Coder works](https://openagents.com/docs/coder-how-it-works.md): Coder sits between you and the coding agents you already use. It makes the quick calls itself, sends only the hard part of the work to the big model, and holds the few steps that are hard to undo… - [Use Coder in the terminal](https://openagents.com/docs/coder-terminal.md): Run coder in a project folder to open it there. To open it on another folder from where you are: - [Choose who answers](https://openagents.com/docs/coder-agents.md): Coder is one chat, whoever answers it. Each chat runs on one of these: - [Coder's plugins](https://openagents.com/docs/coder-plugins.md): Coder's abilities come as plugins you can turn on and off. Type /plugins, or press Ctrl+P (Cmd+P on macOS) or F2. - [Solve an issue](https://openagents.com/docs/coder-solver.md): Solver takes a GitHub issue to a pull request. It works in its own fresh copy of your project, so your checkout isn't touched, and it opens the pull request only when the checks pass. - [Safety](https://openagents.com/docs/coder-safety.md): Coder does ordinary coding work without stopping to ask: reading files, editing them, and running commands such as builds and tests. A short list of actions that are hard to undo always waits for… - [Sync, share, and export](https://openagents.com/docs/coder-sync.md): Coder keeps your chats on your computer. Logged in (coder login), it can keep them on your openagents.com account too, so you can read and answer them on the web and on your phone. - [Coder from scripts](https://openagents.com/docs/coder-scripts.md): openagents coder runs the same chat as the terminal app, without the screen: for scripts, CI jobs, and other agents. It comes with Coder; see Download and install. Run openagents coder --help for… - [Coding agents](https://openagents.com/docs/coding-agents.md): Coder runs the coding agents you already use, on your computer, under your own login with each one. This page covers Coder tasks started from OpenAgents Terminal or openagents chat; for the coder… - [Watch, steer, and stop Coder](https://openagents.com/docs/following-coder.md): A Coder run lives in its chat. You can follow it, add to it, answer it, or stop it from the Terminal or the openagents command. - [Traces](https://openagents.com/docs/traces.md): A trace is a record of an agent run: what you asked, what the agent said, and each step it took, such as a command it ran, with the result. Coder keeps every chat as one, in the open ATIF format.… - [Worktrees and changes](https://openagents.com/docs/worktrees-and-changes.md): A Coder task started from OpenAgents Terminal or openagents chat never works in your checkout. Each task gets its own Git worktree: a separate folder with a copy of your project at its last commit.… - [Work on a GitHub issue](https://openagents.com/docs/github-issues.md): Ask Coder to work an issue and it takes the issue from claim to close: it reads the issue, does the work, runs your checks, lands the change, and reports on the issue. ## Tutorials Step-by-step guides to everyday tasks with Coder and OpenAgents. - [Fix a failing test](https://openagents.com/docs/fix-a-failing-test.md): A test fails and you want it fixed, with the cause explained and nothing else changed. This guide takes you from the red test to a change you've read and committed. - [Use your Claude Code or Codex](https://openagents.com/docs/use-claude-code-or-codex.md): Already pay for Claude or ChatGPT? Coder runs Claude Code and Codex on your own login, so their work comes out of your plan, not out of anything we charge. You keep one chat, with the same keys… - [Pin a model or use Auto](https://openagents.com/docs/pin-a-model.md): Every new chat starts on Auto: Coder looks at your message and picks who answers and on which model. You can pin your own choice instead, for one chat or for every new chat. This guide shows when… - [Queue messages while Coder works](https://openagents.com/docs/queue-messages.md): You don't have to wait for Coder to finish before you type. Each message can either go now, changing what Coder is doing, or wait in a queue and go when the current reply ends. This guide shows both… - [Share a project with a teammate](https://openagents.com/docs/share-a-project.md): A project on openagents.com groups chats, files, and notes around your work, often a GitHub repository. Share one and your teammate sees the same chats and files, and can add their own. This guide… - [Design a part in CAD Lab](https://openagents.com/docs/design-a-part.md): CAD Lab designs parts by talking: say what you want, and it builds the part, checks it, measures it, and keeps every version so you can compare them. This guide makes a small bracket on… - [Follow a run from your phone](https://openagents.com/docs/follow-from-your-phone.md): Start a long task in Coder on your computer, walk away, and keep up with it from your phone: read its steps and send a reply that Coder picks up on your computer. This works in your phone's browser… - [Use Coder on Windows](https://openagents.com/docs/coder-on-windows.md): Coder, its chats, and the openagents command work on Windows, with the same keys and commands as on macOS and Linux. This guide installs Coder in PowerShell, sets up an agent, and covers what's… - [Export and share a chat](https://openagents.com/docs/export-and-share-a-chat.md): Every Coder chat is saved on your computer as you go. You can save one to a file, open it again later or on another computer, or share it with a link. This guide covers all three, and saving a web… ## Computers Connect a computer to your account or your phone, and manage them. - [Connect a computer](https://openagents.com/docs/connect-a-computer.md): When a computer is connected to your openagents.com account, its Coder chats show on the website, in the left panel, where you can reply to them. - [Manage computers](https://openagents.com/docs/manage-computers.md): Settings lists the computers logged in to your account, each with Remove, which signs it out. To add one, run coder login on it; see Connect a computer. ## Plugins Make a plugin, test whether it helps, and publish the result. - [Plugins](https://openagents.com/docs/plugins.md): A plugin is anything you add to OpenAgents. You write one, test whether it helps Coder, and publish it so other people can check your result and use it. - [Write a plugin](https://openagents.com/docs/write-a-plugin.md): There are two ways to make a plugin: in chat, or as a directory of files. - [Test a plugin](https://openagents.com/docs/test-a-plugin.md): A test shows whether a plugin helps. Coder does the same tasks twice: once with the plugin and once without it. Each test is a task (a prompt and the files it starts with) and the checks on what the… - [Publish and share](https://openagents.com/docs/publish-and-share.md): Publishing makes a plugin's test result public, so other people can rerun it, build on it, and use the plugin. ## The Gym, the Verse, and the wallet XP, the shared world, and bitcoin. - [The Gym and XP](https://openagents.com/docs/gym-and-xp.md): The Gym is where plugins are tested on Coder: the same tests with the plugin and without it, so anyone can see whether it helps. It lives in the chat, and its results also stand on boards in the… - [The Verse](https://openagents.com/docs/verse.md): The Verse is a shared world you open in your browser, with nothing to install. Its places run on this site: - [The Grid](https://openagents.com/docs/the-grid.md): The Grid is the OpenAgents Verse world: a floor of white lines with the Gym building, a ball, and scattered blocks, where other players walk around live. Open it in your browser at… - [Wallet](https://openagents.com/docs/wallet.md): OpenAgents for iPhone has a bitcoin wallet on mainnet, with its keys on your phone. It runs on Spark, through Breez's SDK. It's real bitcoin, so keep amounts you'd be comfortable carrying in a phone… ## Reference Settings, keys, commands, pricing, fixes for common problems, and running your own copy. - [Settings](https://openagents.com/docs/settings.md): Coder's settings on a computer live in one file, ~/.openagents/settings.json. OpenAgents Terminal, the openagents command, and the computer's host all read it. With no file, every setting is its… - [Keyboard shortcuts](https://openagents.com/docs/keyboard-shortcuts.md): Every key in Coder, in the web chat, and in the screens they open, in one place. Type /help in Coder to see the short list there. - [Slash commands](https://openagents.com/docs/slash-commands.md): Commands you type in Coder's input. Type / to see them above the input; keep typing to filter, Tab to complete, and Enter to run one. - [Command reference](https://openagents.com/docs/command-reference.md): The commands you run in a terminal, for people rather than scripts. This list comes from the commands' own help: add --help to coder or to openagents GROUP (such as openagents projects --help) for… - [Pricing](https://openagents.com/docs/pricing.md): Free is OpenAgents on your own computer: Coder in front of the agents you already use (Claude Code, Codex, OpenCode, Grok Build, Devin CLI, Cursor), running on your own models, keys and… - [Troubleshooting](https://openagents.com/docs/troubleshooting.md): Open a new terminal: the installer added ~/.openagents/bin to your PATH, and only new terminals see it. Or run it by its full path, ~/.openagents/bin/coder. If you installed with… - [Run your own OpenAgents](https://openagents.com/docs/self-host.md): Everything that runs openagents.com is open source under the Apache 2.0 license, in one repository. You can run your own copy with your own model keys: the website, the account service, the chat… ## Questions and words Short answers, and what each word means. - [FAQ](https://openagents.com/docs/faq.md): Chatting with OpenAgents is free, and we don't count your messages. Coder runs on your own computer with the coding agents you already use there, such as Claude Code and Codex, and each one's own… - [Glossary](https://openagents.com/docs/glossary.md): The words these docs use, in plain terms. ## For agents Docs for agents that use OpenAgents, and for the people who build them: sign up, pay in bitcoin, call the API, and use our MCP server and command. - [Start here](https://openagents.com/docs/agents/start-here.md) if you are an agent: what we offer, sign-up, keys, and errors. - [Docs for agents](https://openagents.com/docs/agents.md): every page below, grouped. ### Start here What we offer an agent, and how it signs itself up. - [For agents: start here](https://openagents.com/docs/agents/start-here.md): What OpenAgents offers an agent, how an agent signs itself up, and the rules every call follows: keys, base addresses, limits, and errors. Every step below is one request or one command. ### Tutorials One task each, with the exact requests and commands. - [Sign up as an agent and make your first call](https://openagents.com/docs/agents/sign-up.md): An agent can make its own OpenAgents account: no person, no email, and no card. It solves a small proof of work, gets an API key and a free amount each day, and pays in bitcoin past that. - [Buy credits over Lightning and check your balance](https://openagents.com/docs/agents/buy-credits.md): An agent account pays in bitcoin over Lightning: it buys a fixed amount of credit, and each model request is then charged what it actually used. Payments are Bitcoin only. - [Read your plan and usage](https://openagents.com/docs/agents/plan-and-usage.md): What your key may spend, what it has spent, and what one request cost. - [Start a chat and stream the answer](https://openagents.com/docs/agents/chat-and-stream.md): Two ways to talk to OpenAgents from code: - [Use the Decisions API](https://openagents.com/docs/agents/decisions.md): Ask typed questions about text and get numbers back: the chance a condition is true, one choice from a fixed set, or a score on ordered levels. No text is written, so an answer comes back in a… - [Create a project, add files, and invite a person](https://openagents.com/docs/agents/projects.md): A project holds chats, files, notes, and repositories, and can be shared with other people. These routes act for one account, so they take that account's login, not an API key. - [Run Coder headless](https://openagents.com/docs/agents/coder-headless.md): Coder, our coding agent, runs from a script or from another agent with openagents coder chat: one prompt in, a stream of JSON lines out, and a session you can continue. Coder runs on your own… - [Connect to our MCP servers](https://openagents.com/docs/agents/mcp.md): We run two MCP servers on openagents.com, both over Streamable HTTP, and the openagents command can serve a third on your own computer. - [Use WebMCP tools in a browser agent](https://openagents.com/docs/agents/webmcp.md): Pages on openagents.com hand their tools to the browser's agent through WebMCP. A browser agent can read the docs, list the models, and start a chat without reading the page's layout. - [Pay per call with x402](https://openagents.com/docs/agents/x402.md): Call a model with no account and no key: pay for each request in bitcoin over Lightning, with x402. Bitcoin only: there is no card, stablecoin, or other chain. ### Reference Every endpoint, error, scope, and command. - [Endpoint catalog](https://openagents.com/docs/agents/endpoints.md): Every endpoint an agent uses, by host. Each row is a route our servers mount today; a test checks this page against the routes in the code. The full machine-readable description is the OpenAPI… - [Error codes](https://openagents.com/docs/agents/errors.md): Every error is JSON with an HTTP status, in one shape: - [Keys and scopes](https://openagents.com/docs/agents/scopes.md): We have two kinds of key, oak_ and oa_sk_: the right one depends on what the agent does. - [Webhooks](https://openagents.com/docs/agents/webhooks.md): We don't send webhooks to API callers today. Everything an agent needs to know comes back on the request, on a stream, or from a call it makes. - [The openagents command for agents](https://openagents.com/docs/agents/cli.md): The openagents commands an agent uses most, with their exact forms. The full list, with every flag, comes from the command itself: ## API - [API docs](https://openagents.com/docs/api.md): One API for many models: Open Responses and Chat Completions at `https://api.openagents.com/v1`. Beta. - [Quickstart](https://openagents.com/docs/api/quickstart.md): The OpenAgents API sends your request to a good model for the job and charges the provider's price plus a small, posted margin. It speaks Open Responses and the OpenAI Chat Completions API, so the… - [Models and prices](https://openagents.com/docs/api/models.md): Beta. Prices on this page are the ones the API charges. - [Typed decisions with System One](https://openagents.com/docs/api/system-one.md): Beta. POST https://api.openagents.com/v1/systemone answers named questions about one state. The question types are noul (probability of yes), choice, and score. It returns JSON answers, not a chat… - [Which model to use](https://openagents.com/docs/api/decisions.md): Start with a task name such as openagents/chat and change it only when you have a reason. Each one picks a model we've measured for that kind of work, and switches providers if one fails before… - [Open Responses](https://openagents.com/docs/api/responses.md): POST /v1/responses is our main API. It follows the Open Responses specification (version 2026-04-24), the open form of OpenAI's Responses API. - [Chat Completions](https://openagents.com/docs/api/chat-completions.md): POST /v1/chat/completions is the OpenAI Chat Completions API. Use it when your code or SDK already speaks it. It reaches the same models, the same way, at the same prices as Open Responses. - [Routing and credits](https://openagents.com/docs/api/routing.md): Every request names a model or a task. We turn that into at most three tries, best first, and answer with the first one that starts writing. - [Bring your own key](https://openagents.com/docs/api/bring-your-own-key.md): You can use your own provider key through the API. Requests on your key go to your provider account, on your terms, and we charge nothing for them. - [Pay per request](https://openagents.com/docs/api/pay-per-request.md): You can call the API with no account and no key: pay for each request in bitcoin over Lightning. This uses x402, an open standard for paying for HTTP requests. - [For agents](https://openagents.com/docs/api/for-agents.md): How an agent finds OpenAgents, says who it is, and pays. Every step is one request or one command. - [Errors](https://openagents.com/docs/api/errors.md): An error comes back as JSON with an HTTP status: - [Limits you set](https://openagents.com/docs/api/limits.md): We don't cap how much you use the API. You can set your own limits on your account and on each key, and we hold every request to them. - [Privacy and data use](https://openagents.com/docs/api/privacy.md): Beta. - [Authentication](https://openagents.com/auth.md): get an API key and send it. - [Agent sign-up](https://openagents.com/auth.md#register-yourself-as-an-agent): an agent registers itself with a small proof of work (`POST https://api.openagents.com/v1/agents/register`), gets a key and a small daily free tier, and pays over Lightning past it. - [For agents](https://openagents.com/docs/api/for-agents.md): find us, say who you are, and pay. Paying per request is off on this API right now; use an API key. - [OpenAPI](https://api.openagents.com/v1/openapi.json): the public API reference, including typed System One decisions. - [API catalog](https://openagents.com/.well-known/api-catalog): where each API and its description live. ## Blog - [Coder 1.0](https://openagents.com/blog/coder-1-0.md) (2026-10-15): Coder 1.0 is out: one Coder in front of every coding agent you use, sending each step where it belongs, with hard-to-undo steps waiting for your Y or N. ## Agent tools - [Docs MCP server](https://openagents.com/mcp/docs): list, search, and read these docs and the model prices as MCP tools over Streamable HTTP. No key needed. - [MCP server card](https://openagents.com/.well-known/mcp/server-card.json): the server's tools and transport. - [Agent card](https://openagents.com/.well-known/agent-card.json): A2A agent card. - [Agent skills](https://openagents.com/.well-known/agent-skills/index.json): skills an agent can install. ## Optional - [Everything in one file](https://openagents.com/llms-full.txt): every guide, API guide, and page for agents. - [Pricing](https://openagents.com/pricing.md) - [What works today](https://openagents.com/promises.md): each thing that works, with its proof. - [Roadmap](https://openagents.com/roadmap.md): what comes next. - [Download](https://openagents.com/download.md) - [Terms of service](https://openagents.com/terms.md) - [Privacy policy](https://openagents.com/privacy.md)