Skip to content
Sma1lboyPublic

About

All your coding agents, in one place. Claude Code, Codex, Copilot and more, side by side in your terminal.

Topics

Resources

Contributing

Stars

188 stars

Watchers

1 watching

Forks

Latest commit

 

History

4,388 Commits

Folders and files

Repository files navigation

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, Codex, Copilot and a dozen more 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

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.

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. 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).
  • The real CLIs. Each task picks its engine; Rove runs that CLI with its own auth, permissions and models (Engines).
  • Sessions that outlive the terminal. Quit the TUI or drop SSH, then reattach. The agents keep working on the host (Sessions).
  • The same tasks everywhere. A browser with rove --web (Web), the iOS and Android apps, a desktop window, WeChat, and other machines 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).
  • Unattended work. A prompt on a schedule (Routines).

How the processes fit together: Architecture. What is planned: Roadmap.

Install

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 ≥ 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.

Scripting and Agent API

rove api gives shell scripts and coding agents the same task model:

rove api add --repo "$PWD" --prompt "Fix the flaky auth test."
rove api read-output --task-id <id>
rove api send --task-id <id> --prompt "Run the integration suite too."
rove api land --task-id <id>

rove skill install teaches a coding agent to drive that loop. Every verb, flag and exit code is in the Agent API reference.

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.

rove plugin search
rove plugin install owner/repo

The catalog is also on rove.run/plugins. To write one, see plugin authoring.

Help and development

rove doctor diagnoses an install; Troubleshooting has the recovery steps.

To work on Rove itself, run bun install then bun run dev:sandbox, and start with CONTRIBUTING.md. Shipped behavior is in the changelog.

License

MIT © Jackson Chen

Star history

Star History Chart

About

All your coding agents, in one place. Claude Code, Codex, Copilot and more, side by side in your terminal.

Topics

Resources

Contributing

Stars

188 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages