Skip to content

endorhq/rover

Repository files navigation

Endor logo

Rover

Endor logo NPM version License Join our Discord

Rover is a manager for AI coding agents that works with Claude Code, Codex, Gemini, and Qwen.

It helps you get more done, faster, by allowing multiple agents to work on your codebase simultaneously. The agents work in the background in separate, isolated environments: they don't interfere with your work or each other.

Rover does not change how you work: everything runs locally, under your control, and using your already installed tools.

Getting Started

First, install Rover and initialize it in your project:

# Install
npm install -g @endorhq/rover@latest

# Initialize
cd <your-project> && rover init .

The init step checks what type of project it is and which coding agents and development tools you use (such as Claude Code and Docker).

Then, run rover task to create a task describing what you want to accomplish in your project and hand it to Rover.

A screencast showing rover task

Rover will:

  • πŸ”’ Prepare a local isolated environment (using containers) with an independent copy of your project code
  • βš™οΈ Install and configure your preferred AI coding agent in that environment
  • πŸ€– Setup a workflow for the agent to complete the task and run it in the background until it finishes
  • πŸ“– Collect a set of developer-friendly documents with information about the changes in the code

Depending on the task complexity, it might take a few minutes. Meanwhile, you can create new tasks and run them in parallel or simply relax, step back and do some other work, whether on your computer or away from it!

Why Rover?

Running and managing multiple AI coding agents simultaneously can be overwhelming. You need to run them isolated from each other and they constantly ask for attention. Context switching quickly becomes a productivity drain.

At the same time, parallel execution is one of the most powerful capabilities of AI coding agents. You can focus on a task while a team of agents complete small issues, start another task, or just write some documentation.

To simplify this process, Rover manages AI coding agents on your behalf. It integrates with both your terminal and VSCode (as an extension).

block-beta
columns 1
  block:Tool
    columns 1
    Repository["Your Repository"]
    Rover
  end
  space
  block:ID
    block:group1
        columns 1
        Task1["Task 1: Add a new feature ..."]
        Agent1["Claude"]
        Repo1["Git Worktree (rover/1-xxx)"]
        Container1["Container (rover-1-1)"]
    end
    block:group2
        columns 1
        Task2["Task 2: Add a missing docs ..."]
        Agent2["Gemini"]
        Repo2["Git Worktree (rover/2-xxx)"]
        Container2["Container (rover-2-1)"]
    end
    block:group3
        columns 1
        Task3["Task 3: Fix issue X ..."]
        Agent3["Claude"]
        Repo3["Git Worktree (rover/3-xxx)"]
        Container3["Container (rover-3-1)"]
    end
  end
  block
    Computer["Your Computer"]
  end
  Tool --> ID
  style Rover fill:#107e7a,stroke:#107e7a
Loading

Main features

  • πŸš€ Easy to use: Manage multiple AI coding agents working on different tasks with a single command
  • πŸ”’ Isolated: Prevent AI Agents from overriding your changes, accessing private information or deleting system files
  • πŸ€– Bring your AI agents: Use your existing AI agents like Claude Code, Codex, Gemini, and Qwen. No new subscriptions needed
  • πŸ’» Local: Everything runs on your computer. No new apps and permissions in your repositories
  • πŸ‘ Open Source: Released under the Apache 2 license

Quickstart

Prerequisites

You need at least one supported AI agent in your system:

Installation

Terminal

Install it using npm:

npm install -g @endorhq/rover@latest

First steps

  1. Initialize Rover in your project:

    cd <your-project> && rover init .
  2. Create your first task with Rover:

    rover task
  3. Check the status of your task:

    rover ls -w
  4. Keep working on your own tasks πŸ€“

  5. After finishing, check the task result:

    rover inspect 1
    rover inspect 1 --file changes.md
    rover diff 1
  6. If you want to apply more changes, create a second iteration with new instructions:

    rover iterate 1
  7. If you need to apply changes manually, jump into the task workspace:

    rover shell 1
  8. If changes are fine, you can:

    • Merge them:
    rover merge 1
    • Push the branch to the remote using your git configuration:
    rover push 1
    • Take manual control:
    rover shell 1
    git status

πŸ’‘ TIP: You can run multiple tasks in parallel. Just take into account your AI agents' limits.

VSCode

Rover is available on the VSCode Marketplace. You can look for Rover in your VSCode Extensions Panel or access the Marketplace page and click Install there.

If the Rover CLI is not in the PATH or the project is not initialized, the extension will guide you through the initialization process. Once everything is ready, you will be able to create your first task!

See the VSCode documentation site.

How it works

Rover relies on local tools you already have like Git, Docker/Podman and AI coding agents. When you initialize it in a project (using rover init), it identifies the project requirements and the available tools in your environment.

Once you create a task, Rover creates a separate git worktree (workspace) and branch for that task. It starts a container, mounts the required files, installs tools, configures them, and lets your AI agent complete a workflow. Rover workflows are a set of predefined steps for AI coding agents. Depending on the workflow, you might get a set of changes in the workspace or a document with research.

After an AI agent finishes the task, all code changes and output documents are available in the task workspace (git worktree). You can inspect those documents, check changes, iterate with an AI agent, or even take full control and start applying changes manually. Every developer has a different workflow, and Rover won't interfere with it.

Once you are ready, you can merge changes or push the branch. That's it! πŸš€

Report Issues

Found a bug or have a feature request? Please open an issue on GitHub. We appreciate detailed bug reports and thoughtful feature suggestions.

Join the Community

We'd love to hear from you! Whether you have questions, feedback, or want to share what you're building with Rover, there are multiple ways to connect.

License

Rover is open source software licensed under the Apache 2.0 License.


Built with ❀️ by the Endor team

We build tools to make AI coding agents better

About

A manager for AI coding agents that works with Claude Code, Gemini, Codex, and Qwen.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors 3

  •  
  •  
  •