OpenAgentd

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="documents/assets/brand/openagentd-banner-dark.webp"> <img src="documents/assets/brand/openagentd-banner-light.webp" alt="OpenAgentd: the coding agent that shows its work" width="100%"> </picture> </p> <p align="center"> <a href="https://github.com/lthoangg/openagentd/releases/latest"><img src="https://img.shields.io/github/v/release/lthoangg/openagentd?label=release&color=5AA8E2" alt="Latest release"></a> <a href="https://github.com/lthoangg/openagentd/releases"><img src="https://img.shields.io/github/downloads/lthoangg/openagentd/total?color=3F3429" alt="Downloads"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-3F3429" alt="Apache 2.0"></a> <a href="https://discord.gg/cz6GQHQUMg"><img src="https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white" alt="Discord"></a> </p> <p align="center"> <a href="https://openagentd.dev">Website</a> · <a href="#install">Install</a> · <a href="#a-quick-tour">Tour</a> · <a href="https://openagentd.dev/features/">Features</a> · <a href="https://discord.gg/cz6GQHQUMg">Discord</a> · <a href="CONTRIBUTING.md">Contribute</a> </p> **OpenAgentd is a desktop app for running a coding agent on your own machine.** You give it a folder and a task. It plans, reads, edits, runs your tests, and shows you every step: each tool call with its arguments and timing, every diff, and what each turn costs. You can steer it mid-turn, review its changes before you commit, and use the models and keys you already have. <picture> <source media="(prefers-color-scheme: dark)" srcset="documents/assets/readme/hero-dark.webp"> <img src="documents/assets/readme/hero-light.webp" alt="OpenAgentd workspace: the agent's tool calls and test runs on the left, its uncommitted Git diff on the right"> </picture> _{A real session, unedited: the agent added rate limiting to a small Bun service, ran the suite, and left the changes uncommitted for review.} ## Why OpenAgentd - **Nothing happens off-screen.** Tool calls, reasoning, shell output, file edits, todos, tokens and cost stream into one transcript. Collapse it to just the answers with Reader mode when you only want the result. - **You decide when code changes.** Plan mode explores read-only and writes a plan you can comment on, then approve. In Code mode you can steer, queue, or stop a running turn. - **Made for real repositories.** Git changes, history and graph, worktrees, a real terminal, a live preview of your web app, and language-server diagnostics after edits. - **Your models, your keys.** 19+ providers, including Anthropic, OpenAI, Gemini, OpenRouter, Bedrock and DeepSeek, plus your existing ChatGPT, Copilot or Grok subscription, or local models through Ollama. - **Local-first, and small.** A single native Rust backend (about 43 MB, cold start around 30 ms, about 20 MB idle). Sessions, settings and telemetry stay on your machine. Phones and other computers connect only when you turn on network access. ## Install **macOS and Linux** ```bash curl -fsSL https://openagentd.dev/install.sh | sh ``` **Windows** (PowerShell) ```powershell irm https://openagentd.dev/install.ps1 | iex ``` **Homebrew** (macOS) ```bash brew install --cask lthoangg/tap/openagentd ``` Open **OpenAgentd**, add a provider in **Settings → Providers** (or point it at Ollama), open a folder and describe what you want built. The desktop app starts its own backend; there is nothing else to run. The [setup guide](https://openagentd.dev/download/desktop/) walks through providers and first launch, and builds for every platform are on the [releases page](https://github.com/lthoangg/openagentd/releases/latest). Unsigned builds may ask you to confirm before the first launch. **iPhone and Android** apps connect to OpenAgentd on your computer: see the [iOS](https://openagentd.dev/download/ios/) and [Android](https://openagentd.dev/download/android/) guides. To build from source, see [CONTRIBUTING.md](CONTRIBUTING.md#quick-start). ### CLI server Install only the backend to run it from a terminal, use it from a browser, or serve other devices: ```bash curl -fsSL https://openagentd.dev/install.sh | sh -s -- --cli agentd server start # add --public --key --qr to pair a phone agentd run --prompt "Summarize this project" agentd run --continue --prompt "Now add tests for it" ``` ```powershell # Windows PowerShell & ([scriptblock]::Create((irm https://openagentd.dev/install.ps1))) -Cli ``` The server serves the API only: connect to the printed `Server:` address from the desktop or mobile app. There is no built-in TLS, so put an HTTPS reverse proxy in front of it before exposing it outside a trusted network. `agentd --help` lists every command. ## A quick tour <table> <tr> <td width="50%" valign="top"> <picture> <source media="(prefers-color-scheme: dark)" srcset="documents/assets/readme/plan-dark.webp"> <img src="documents/assets/readme/plan-light.webp" alt="Plan review with Approve and Request changes"> </picture> <h3>Plan first, then build</h3> In Plan mode the agent explores without editing and writes a plan. Select any passage to comment on it, then <b>Approve</b> or <b>Request changes</b>. Press <kbd>Tab</kbd> in the composer to switch modes. </td> <td width="50%" valign="top"> <picture> <source media="(prefers-color-scheme: dark)" srcset="documents/assets/readme/subagents-dark.webp"> <img src="documents/assets/readme/subagents-light.webp" alt="A lead agent summarising an explorer subagent's report"> </picture> <h3>Hand work to subagents</h3> The lead agent delegates focused jobs to subagents such as <code>explorer#1</code>. Their reports fold into the conversation, and the sidebar shows who is working on what. </td> </tr> </table> The [full tour](https://openagentd.dev/features/) covers agent teams, the scheduler, web preview, plugins, MCP and skills, memory, telemetry and more. The [feature catalogue](documents/docs/features.md) lists every shipped capability with the release that introduced it. ## Community - [openagentd.dev](https://openagentd.dev) for features, setup guides and downloads. - [Discord](https://discord.gg/cz6GQHQUMg) and the [Facebook group](https://www.facebook.com/groups/1256361676707935) for questions and chat. - [Issues](https://github.com/lthoangg/openagentd/issues) for bugs, requests and roadmap discussion. - [Releases](https://github.com/lthoangg/openagentd/releases) for builds and release notes. - [Security policy](SECURITY.md) to report a vulnerability privately. - [Contributing](CONTRIBUTING.md) to set up a checkout and send changes. OpenAgentd is open source under the [Apache 2.0 license](LICENSE).