# Rove: all your coding agents, in one place

Rove: all your coding agents, in one place. Works with Claude Code, Codex, Copilot, and Kimi.

Rove is an agentic development environment (ADE) for your terminal. [Claude Code](https://claude.com/claude-code), [Codex](https://github.com/openai/codex), [Copilot](https://github.com/github/copilot-cli) and [a dozen more](./docs/ENGINES.md) work side by side in one window, each task in its own git worktree and branch, and they keep running when you disconnect.

npm version build MIT license

Documentation · Quick start · Concepts · CLI · Agent API · Website

Rove demo: three repos, two engines, three agents running at once; the terminal closes, the agents keep working, and on reopening the Inbox lists their finished turns and one task's diff

## Quick start ```bash curl -fsSL https://rove.run/install.sh | sh cd your-repo rove ``` Press `n` to create your first task. You need git and at least one agent CLI on `PATH`. The script covers macOS, Linux and WSL; for npm, bun, npx and native Windows see [Install](#install). ## Why more than one agent - **Out of quota? Switch to another agent.** When Claude Code hits its usage limit halfway through a task, [switch the task to Codex or any other engine](./docs/ENGINES.md). The new agent reads what the last one did and continues on the same branch. - **Agents talk to each other directly.** One agent hands work to another with `rove api add` and gets the report back in its own tab. You don't copy text between windows. ## What you get

Any agent CLI. Pick one per task. Built in: Claude Code, Codex, GitHub Copilot, Kimi Code, Pi, OMP, IBM Bob. From the catalog, when the CLI is on your PATH: Gemini CLI, OpenCode, Cursor Agent, Grok CLI, Droid, Amp, Devin, Qoder CLI, Cline, Kiro CLI, Maki, Antigravity, Hermes, Kilo, MastraCode. Yours: any command you register, or an engine from a plugin.

- **A worktree and branch per task.** A refactor, a bug fix and a review run at the same time without overwriting each other's files ([Concepts](./docs/CONCEPTS.md)). - **The real CLIs.** Each task picks its engine; Rove runs that CLI with its own auth, permissions and models ([Engines](./docs/ENGINES.md)). - **Sessions that outlive the terminal.** Quit the TUI or drop SSH, then reattach. The agents keep working on the host ([Sessions](./docs/SESSIONS.md)). - **The same tasks everywhere.** A browser with `rove --web` ([Web](./docs/WEB.md)), the [iOS](./docs/IOS.md) and [Android](./docs/ANDROID.md) apps, a [desktop window](./docs/DESKTOP.md), [WeChat](./docs/WEIXIN.md), and [other machines](./docs/MACHINES.md) over SSH. - **Review and follow-up.** Diff views with inline notes that go back as one prompt, an Inbox of agents waiting for you, and a PR from a finished task ([TUI guide](./docs/TUI.md)). - **Unattended work.** A prompt on a schedule ([Routines](./docs/ROUTINES.md)). How the processes fit together: [Architecture](./docs/ARCHITECTURE.md). What is planned: [Roadmap](./docs/ROADMAP.md). ## Install ```bash npm install -g @sma1lboy/rove # offers to install Bun on first launch bun install -g @sma1lboy/rove # if you already run Bun npx @sma1lboy/rove # try it without installing ``` Rove runs on macOS, Linux and Windows, on [Bun](https://bun.sh) ≥ 1.3.11, which every install route brings along. Native Windows also needs Node.js and Git for Windows with Git Bash, and installs through npm, not the `curl` script. Details: [Quick start](./docs/QUICKSTART.md). ## Scripting and Agent API `rove api` gives shell scripts and coding agents the same task model: ```bash rove api add --repo "$PWD" --prompt "Fix the flaky auth test." rove api read-output --task-id rove api send --task-id --prompt "Run the integration suite too." rove api land --task-id ``` `rove skill install` teaches a coding agent to drive that loop. Every verb, flag and exit code is in the [Agent API reference](https://docs.rove.run/rove/api). ## Plugins

Make it yours: rove plugin search lists the first-party plugins notify, github-start, worktree-include, linear-start, lazygit, and browser, beside a mod's Counter pane that the TUI and the web both draw.

A plugin is a directory with a `rove-plugin.toml` manifest and commands in any language. It can add panes, react to events, register commands and settings, contribute engines, and ship a mod: one process whose pane the TUI and the browser both draw. ```bash rove plugin search rove plugin install owner/repo ``` The catalog is also on [rove.run/plugins](https://rove.run/plugins). To write one, see [plugin authoring](./docs/PLUGIN-AUTHORING.md). ## Help and development `rove doctor` diagnoses an install; [Troubleshooting](./docs/TROUBLESHOOTING.md) has the recovery steps. To work on Rove itself, run `bun install` then `bun run dev:sandbox`, and start with [CONTRIBUTING.md](./CONTRIBUTING.md). Shipped behavior is in the [changelog](./packages/rove/CHANGELOG.md). ## License [MIT](./LICENSE) © Jackson Chen ## Star history Star History Chart