reevesagents

<p align="center"><a href="https://reevesagents.mertkayacs.com/"><img src="assets/banner.webp" width="1050" alt="ReevesAgents is free and open source under the Apache-2.0 license"></a></p>

<p align="center">
  <a href="https://github.com/mertkayacs/reevesagents"><img src="https://img.shields.io/github/stars/mertkayacs/reevesagents?style=flat&logo=github" alt="GitHub stars" /></a>
  <a href="https://www.npmjs.com/package/reevesagents"><img src="https://img.shields.io/npm/v/reevesagents.svg" alt="npm version" /></a>
  <a href="https://www.npmjs.com/package/reevesagents"><img src="https://img.shields.io/npm/dm/reevesagents" alt="monthly npm downloads" /></a>
  <a href="https://www.npmjs.com/package/reevesagents"><img src="https://img.shields.io/npm/dt/reevesagents" alt="total npm downloads" /></a>
  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/reevesagents.svg" alt="node" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/npm/l/reevesagents.svg" alt="license" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/free%20and%20open%20source-006d77" alt="free and open source" /></a>
  <a href="https://github.com/mertkayacs/reevesagents/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/mertkayacs/reevesagents/test.yml?branch=master&label=CI" alt="CI" /></a>
</p>

ReevesAgents is free and open source under the Apache-2.0 license.

<p align="center">
  <a href="https://reevesagents.mertkayacs.com/demo/"><b>Demo</b></a> ·
  <a href="https://reevesagents.mertkayacs.com/docs/"><b>Docs</b></a> ·
  <a href="https://reevesagents.mertkayacs.com/faq/"><b>FAQ</b></a> ·
  <a href="https://github.com/mertkayacs/reevesagents/issues"><b>Issues</b></a>
</p>

<p align="center">
  <img src="docs/assets/providers/cc.svg" width="40" height="40" alt="Claude Code" title="Claude Code">
  <img src="docs/assets/providers/codex.svg" width="40" height="40" alt="Codex CLI" title="Codex CLI">
  <img src="docs/assets/providers/opencode.svg" width="40" height="40" alt="OpenCode" title="OpenCode">
  <img src="docs/assets/providers/hermes.svg" width="40" height="40" alt="Hermes" title="Hermes">
  <img src="docs/assets/providers/kimi.svg" width="40" height="40" alt="Kimi Code" title="Kimi Code">
  <img src="docs/assets/providers/deepseek.svg" width="40" height="40" alt="DeepSeek CLI" title="DeepSeek CLI">
  <img src="docs/assets/providers/pi.svg" width="40" height="40" alt="Pi" title="Pi">
  <img src="docs/assets/providers/qwen.svg" width="40" height="40" alt="Qwen Code" title="Qwen Code">
  <img src="docs/assets/providers/aider.svg" width="40" height="40" alt="Aider" title="Aider">
</p>
<p align="center">
  <img src="docs/assets/providers/gemini.svg" width="40" height="40" alt="Gemini CLI" title="Gemini CLI">
  <img src="docs/assets/providers/cline.svg" width="40" height="40" alt="Cline CLI" title="Cline CLI">
  <img src="docs/assets/providers/crush.svg" width="40" height="40" alt="Crush" title="Crush">
  <img src="docs/assets/providers/goose.svg" width="40" height="40" alt="Goose" title="Goose">
  <img src="docs/assets/providers/kilo.svg" width="40" height="40" alt="Kilo Code" title="Kilo Code">
  <img src="docs/assets/providers/letta.svg" width="40" height="40" alt="Letta Code" title="Letta Code">
  <img src="docs/assets/providers/vibe.svg" width="40" height="40" alt="Mistral Vibe" title="Mistral Vibe">
  <img src="docs/assets/providers/grok.svg" width="40" height="40" alt="Grok Build" title="Grok Build">
  <img src="docs/assets/providers/kiro.svg" width="40" height="40" alt="Kiro CLI" title="Kiro CLI">
</p>
<p align="center">
  <img src="docs/assets/providers/droid.svg" width="40" height="40" alt="Factory Droid" title="Factory Droid">
  <img src="docs/assets/providers/qoder.svg" width="40" height="40" alt="Qoder CLI" title="Qoder CLI">
  <img src="docs/assets/providers/warp.svg" width="40" height="40" alt="Warp" title="Warp">
  <img src="docs/assets/providers/junie.svg" width="40" height="40" alt="Junie CLI" title="Junie CLI">
  <img src="docs/assets/providers/copilot.svg" width="40" height="40" alt="GitHub Copilot CLI" title="GitHub Copilot CLI">
  <img src="docs/assets/providers/cursor.svg" width="40" height="40" alt="Cursor CLI" title="Cursor CLI">
  <img src="docs/assets/providers/rovo.svg" width="40" height="40" alt="Rovo Dev CLI" title="Rovo Dev CLI">
</p>
<p align="center">
  <img src="docs/assets/providers/pplx.svg" width="40" height="40" alt="Perplexity" title="Perplexity">
  <img src="docs/assets/providers/colab.svg" width="40" height="40" alt="Google Colab" title="Google Colab">
  <img src="docs/assets/providers/hf.svg" width="40" height="40" alt="Hugging Face" title="Hugging Face">
  <img src="docs/assets/providers/ollama.svg" width="40" height="40" alt="Ollama" title="Ollama">
</p>

**English** · [Deutsch](docs/i18n/README.de.md) · [Français](docs/i18n/README.fr.md) · [Español](docs/i18n/README.es.md) · [Português](docs/i18n/README.pt.md) · [Italiano](docs/i18n/README.it.md) · [Türkçe](docs/i18n/README.tr.md) · [Русский](docs/i18n/README.ru.md) · [简体中文](docs/i18n/README.zh-Hans.md) · [العربية](docs/i18n/README.ar.md)

ReevesAgents is a local workspace for AI coding CLIs. It runs Claude Code,
Codex, OpenCode, Hermes, Kimi, DeepSeek, Qwen, Pi, Aider, Gemini CLI, Cline CLI,
Crush, Goose, Kilo Code, Letta Code, Mistral Vibe, Grok Build, Kiro CLI,
Factory Droid, Qoder CLI, Warp, Junie CLI, GitHub Copilot CLI, Cursor CLI,
Rovo Dev CLI, and other provider CLIs side by side in tmux. You can use it as a
normal CLI/TUI/Web UI, or attach its opt-in MCP so one agent can spawn, read,
steer, and stop the rest.

Provider logins stay inside each provider CLI. ReevesAgents keeps its own state
as a few plain JSON files under `~/.reeves`, and it runs only while you or an
attached CLI are using it.

<img src="https://raw.githubusercontent.com/mertkayacs/reevesagents/master/docs/assets/reevesagents-hero.webp" width="720" alt="A gold-framed lead pane joined by fine gold threads to eight glowing glass panes, one for each tool in a run">

## Quick Start

```sh
pnpm add -g reevesagents
reevesagents doctor
reevesagents
```

Start a run from the CLI:

```sh
reevesagents spawn claude-code:lead codex:tests hermes:research \
  --name "release check" \
  --prompt "Review the release path, test coverage, and docs."
```

Open the Web UI:

```sh
reevesagents web
```

Let one attached agent drive the others:

```sh
reevesagents attach codex
reevesagents hosts
```

Restart that CLI after attach so it loads the MCP tools.

## What It Gives You

| Surface | Use it for |
| --- | --- |
| **TUI** | Keyboard-first run control inside the terminal. |
| **Web UI** | Local visual view of runs, panes, agents, approvals, and history. |
| **CLI** | Scripts, smoke checks, spawning, state cleanup, and tmux jumps. |
| **Agent Control MCP** | One trusted CLI can spawn and drive other CLIs through local tools. |
| **tmux** | Real provider CLI windows that keep running after the UI closes. |

ReevesAgents is local by design. State is plain JSON under `~/.reeves`, and the
CLIs it starts are the same CLIs you already use by hand.

## Tools

Four tools sit next to the coding CLIs. Perplexity CLI searches the web,
Google Colab CLI runs scripts and notebooks on CPU, GPU and TPU runtimes,
Hugging Face CLI downloads and uploads models and datasets and runs jobs on the
Hub, and Ollama runs local or cloud models from the terminal. Agents call them
from their own shell.

`reevesagents tools` lists the four with a purpose, an example command, and
whether each is installed and signed in (for Ollama: reachable). Add `--json`
for scripts. An agent with the MCP attached gets the same list from
`list_tools`.

<a id="install"></a>
<details>
<summary><strong>Install</strong></summary>

ReevesAgents needs Node.js `22.12+`, tmux `3.0+`, and at least one supported
provider CLI installed and authenticated. It supports macOS, Linux, and WSL.

```sh
# Homebrew
brew tap mertkayacs/reevesagents
brew install reevesagents

# pnpm
pnpm add -g reevesagents

# npm
npm install -g reevesagents

# one-shot checks
pnpm dlx reevesagents doctor
npx reevesagents doctor
```

Pin a version by replacing `<version>`:

```sh
pnpm add -g reevesagents@<version>
```

Source install:

```sh
git clone https://github.com/mertkayacs/reevesagents.git
cd reevesagents
pnpm install
pnpm build
pnpm link --global
reevesagents doctor
```

</details>

<a id="screenshots"></a>
<details>
<summary><strong>Screenshots</strong></summary>

The TUI and Web UI drive the same local runs:

![ReevesAgents Web UI: runs and live agent panes](https://raw.githubusercontent.com/mertkayacs/reevesagents/master/docs/assets/reevesagents-web-en.png)

![ReevesAgents Web UI: starting a new run](https://raw.githubusercontent.com/mertkayacs/reevesagents/master/docs/assets/reevesagents-newrun-en.png)

</details>

<a id="commands"></a>
<details>
<summary><strong>Commands</strong></summary>

No arguments launches the TUI.

| Command | Purpose |
| --- | --- |
| `reevesagents` | Launch the TUI. |
| `spawn [spec...]` | Start a run. Each spec is `provider[:nickname[:model]]`. |
| `add [spec...]` | Add agents to the most recent active run. |
| `runs` | List active runs. |
| `agents [run-id]` | List agents across runs or inside one run. |
| `open <id>` | Jump to a run or agent tmux window. |
| `peek <agent-id>` | Print recent output from one agent. |
| `send <agent-id> <text...>` | Paste text into an agent without submitting. |
| `key <agent-id> <key>` | Send `enter`, `escape`, arrows, `tab`, `space`, `backspace`, or `ctrl-c`. |
| `interrupt <agent-id>` | Send Ctrl-C to one agent. |
| `stop <run-id>` | Stop a run. Requires `--yes` or `ALLOW_DESTRUCTIVE=1`. |
| `kill <agent-id>` | Stop one agent. Requires `--yes` or `ALLOW_DESTRUCTIVE=1`. |
| `setup` | First-run check. `--attach` connects every installed host CLI. |
| `doctor` | Check Node, tmux, state, and provider CLIs. |
| `web` | Start t