reevesagents

ReevesAgents を使用するには、Node.js 22.12+、tmux 3.0+、およびインストールして認証済みのサポート対象プロバイダー CLI が少なくとも 1 つ必要です。macOS、Linux、WSL に対応しています。

# 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

バージョンを固定するには、<version> を置き換えます：

pnpm add -g reevesagents@<version>

ソースからインストールする場合：

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

TUI と Web UI は、同じローカル実行を操作します：

引数を指定しない場合、TUI が起動します。

一般的なフラグ：

• --json：スクリプト向けの一覧表示およびアクションコマンドで使用できます。
• --name <name>：実行に名前を付けます。
• --cwd <dir>：指定したディレクトリからエージェントを実行します。
• --prompt <text>：起動時のテキストを、起動する各エージェントに入力します。
• --skip：無人ワーカー向けに、プロバイダーの権限確認をスキップします。
• --run <run-id>：指定した実行にエージェントを追加します。
• --port <n> および --no-open：Web UI の起動オプションです。

Agent Control はオプションの MCP サーバーです。ローカルツールを操作することを信頼できる CLI にのみ接続してください。

reevesagents attach claude
reevesagents hosts

再起動後、その CLI では spawn、read、send_text、 send_key、interrupt、kill、stop、承認の管理、プリセットの管理、 ホストの確認に使うツールを利用できます。プロバイダーカタログも reevesagents://providers として公開されます。

Claude Code では、接続と操作手順をまとめてプラグインとしてインストールできます。

claude plugin marketplace add mertkayacs/reevesagents
claude plugin install reevesagents@reevesagents

サーバーは公式 MCP レジストリに io.github.mertkayacs/reevesagents として登録されています。

ワーカーには、デフォルトでは MCP が提供されません。ワーカー自身に ワーカーを作成させる場合は、そのワーカーの CLI に ReevesAgents を 明示的に接続してください。

状態は ~/.reeves 配下に保存されます。

~/.reeves/
  config.json
  presets/
  runs/
  history/

次の 2 つの環境変数でデフォルトのパスを上書きできます。

• REEVES_REGISTRY：runs/、history/、presets/ の状態ルートを上書きします。
• REEVES_CONFIG：設定ファイルのパスを上書きします。

Web UI で Config を開き、Web theme → Light または Dark を選んで保存します。選択内容は config.json に保存され、組み込みターミナルにも適用されます。デフォルトは Dark です。CLI からは reevesagents config web_theme light を使用してください。

tmux サーバーごとにレジストリを 1 つ使用してください。バックグラウンドの孤立セッションの一括処理では、現在のレジストリに基づいてセッションの所有者を判定するため、2 つのレジストリで 1 つの tmux サーバーを共有しないでください。

エージェントのタスク、タスクメモ、受信トレイのメッセージ、承認テキストは、状態ファイルに書き込む前に、既知のトークンパターンがマスキングされます。

1 つのプロジェクトを複数の CLI に分散させます。

reevesagents spawn deepseek:backend claude-code:product codex:review \
  --name "feature x" \
  --prompt "Backend, product copy, and a review pass."

エージェントを監視してから、そのウィンドウを開きます。

reevesagents peek backend -n 40
reevesagents open backend

作業が完了したら実行を停止します。

reevesagents stop "feature x" --yes

reevesagents web

Web UI は 127.0.0.1 のみでバインドし、フォアグラウンドで実行されます。エージェントは tmux 内で動作するため、ページを閉じた後も実行を続けます。

Web UI は、ws と @lydell/node-pty のオプションのランタイムモジュールを使用します。npm はデフォルトでこれらをインストールします。CLI と TUI のコマンドは、これらのモジュールがなくても引き続き動作し、reevesagents web で不足しているものを確認できます。

別のマシンからアクセスするには、SSH 経由でループバックポートを転送します。

ssh -L 8080:127.0.0.1:8080 user@host

tmux がインストールされていません。 tmux をインストールして reevesagents doctor を実行してください。TUI は reeves という名前の tmux セッション内で自動的に実行されます。この動作をスキップするには REEVES_NO_TMUX_WRAPPER=1 を設定してください。

プロバイダーの CLI が見つからないか、サインアウトされています。 ReevesAgents は、PATH 上にあり認証済みのプロバイダー CLI を起動します。reevesagents doctor で検出された内容を確認できます。起動したウィンドウがログイン待ちの場合は、peek で確認できます。

Web UI に不足しているパッケージが表示されます。 オプションの依存関係を有効にして再インストールし、reevesagents doctor を実行してください。

ポートがすでに使用されています。 reevesagents web はデフォルトで 8080 から起動します。使用中の場合、サーバーは狭い範囲内にある次の空きポートにバインドし、URL を表示します。

コントリビューター向けドキュメントは docs/ にあります。 まず CONTRIBUTING.md、テスト、リリースを確認してください。

エンドユーザーに開発ツールチェーンは必要ありません。コントリビューターは、リポジトリに含まれる pnpm、TypeScript、tsup、Vitest、ESLint を使用します。