wanman

English | 中文 | 日本語

Agent Matrix フレームワーク — 監督下の Claude Code あるいは Codex エージェントのネットワークを起動し、あなたのマシン上で協調動作させます。

wanman はオープンソースのローカルモード Agent Matrix フレームワークです。監督下の Claude Code あるいは Codex エージェントのネットワークをあなたのマシン上で動かし、JSON-RPC スーパーバイザーを介して協調動作させます。

wanman について

wanman という名前は、日本語の ワンマン電車 / one-man train に由来します。車掌なしで 1 人の運転士が運行する電車です。wanman の設計目標もこのイメージに近く、人間のユーザーが観察者の役割に退き、agent matrix が自動実行される様子を全方位から観察できるようにすることです。

wanman.ai は、wanman の完全自動 24/7 サンドボックス版を提供しています。これは Sandbank Cloud のサンドボックスクラウド上で完全無料で動作します。

何をするか

• 複数のエージェント（CEO、dev、devops、marketing、feedback など）を、steer/follow-up 優先度付きの非同期メッセージバスで連携させます。
• 各エージェントを実際の Claude Code または Codex CLI サブプロセスとして実行します。CLI 認証はあなた自身のものを利用し、wanman は spawn、プロンプト送出、ライフサイクルを統括します。
• すべてのエージェントをエージェントごとのワークツリーとエージェントごとの $HOME で隔離するため、エージェントがあなたの汚れた作業コピーやシェルプロファイルを変更することはありません。
• CLI ファーストです。すべてが wanman コマンドと JSON-RPC スーパーバイザー経由でスクリプト化可能、観測可能、再現可能です。

wanman.ai は、ホステッド版だけの機能も提供します: - 各 agent runtime グループを個別の sandbox 環境に隔離し、大規模・高並行のタスク実行をサポートします。 - agents の役割を動的に設定し、インターネット上の優れた agent 役割カタログから役割を自動抽出できます。 - 動的な skill の自己進化をサポートします。 - db9 によるグローバル検索とストーリー検索をサポートします。

Quickstart

# 前提条件: Node 20+, pnpm 9+, git, ログイン済みの Claude Code または Codex CLI。
git clone git@github.com:chekusu/wanman.git wanman.dev
cd wanman.dev
pnpm install
pnpm build

# ソースから直接実行します。npm package の公開は不要です。
pnpm --filter @wanman/cli exec wanman takeover /path/to/any/git/repo

単一ファイルの CLI bundle が必要な場合:

pnpm --filter @wanman/cli standalone
node packages/cli/dist/wanman.mjs takeover /path/to/any/git/repo

wanman がすでに PATH にある場合は、対象リポジトリ内で wanman takeover . を直接実行できます。

完全な手順は docs/quickstart.ja.md を参照してください。

CLI コマンド

最新の完全なリストは wanman --help を実行して確認してください。

アーキテクチャ

+----------------+          +--------------------+          +-----------------+
|  wanman CLI    |  JSON    |  Supervisor        |  spawn   |  Agent process  |
|  (host shell)  | ---RPC-->|  (local process)   | -------> |  (Claude/Codex) |
|                |  /rpc    |  message/context/  |          |  per-agent $HOME|
|                |          |  task/artifact     |          |  per-agent wt   |
+----------------+          +--------------------+          +-----------------+
                                    |                              |
                                    v                              v
                           +--------------------+        +-----------------+
                           |  files + SQLite    |        |  worktree       |
                           +--------------------+        +-----------------+

• wanman <subcommand> は Supervisor プロセスに対して JSON-RPC 2.0 で通信します。
• Supervisor は message store、context store、task pool、artifact store を保有し、エージェントごとに 1 つの子プロセスを spawn します。
• 各エージェントの子プロセスはローカルの Claude Code または Codex サブプロセスで、エージェントごとのワークツリーと隔離された $HOME に紐付いています。

詳細: docs/architecture.ja.md。

設定

クロスラン記憶のために、オプションで @sandbank.dev/db9 brain アダプタを接続できます — docs/architecture.ja.md を参照してください。

エージェント設定

エージェントの定義は単一の JSON ファイルに記述します:

{
  "agents": [
    { "name": "echo", "lifecycle": "24/7", "model": "standard", "systemPrompt": "..." },
    { "name": "ping", "lifecycle": "on-demand", "model": "standard", "systemPrompt": "..." }
  ],
  "dbPath": ".wanman/wanman.db",
  "port": 3120,
  "workspaceRoot": ".wanman/agents"
}

エージェントエントリごとに以下のフィールドがあります: - name — メッセージバス上で使われる一意識別子です。 - lifecycle — 24/7（連続再生成ループ）または on-demand（トリガーがあるまでアイドル）。 - model — 通常は抽象 tier（high または standard）を使います。runtime アダプタが Claude または Codex のデフォルトモデルに解決し、環境変数で上書きできます。 - systemPrompt — 組み込みのペルソナ/ミッションです。エージェントは ~/.claude/skills/ にある共有 skill ファイルも自動検出します。 - オプションの cron、events、tools フィールド — 完全なスキーマは architecture ドキュメントを参照してください。

Testing

pnpm typecheck
pnpm test
pnpm exec vitest run --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary --coverage.exclude='**/dist/**'

現在のカバレッジ目標は、行カバレッジ 90% 以上です。直近のローカル検証では Lines: 90.17% でした。機械可読のサマリーは coverage/coverage-summary.json に出力されます。

プロジェクト構造

wanman.dev/
  packages/
    cli/                 wanman CLI (send/recv/task/artifact/run/takeover/...)
    core/                Shared types, JSON-RPC protocol, skills (core/skills/)
    host-sdk/            Host-side SDK for embedding wanman into other tools
    runtime/             Supervisor, agent process manager, SQLite stores, adapters
  docs/                  Architecture and quickstart guides

現在同梱されている共有 skill（packages/core/skills/）: - artifact-naming, artifact-quality — エージェントが生成する artifact の規約です。 - cross-validation — CEO によるエージェント出力の整合性チェックです。 - research-methodology — マーケット/データ調査の方法論です。 - wanman-cli — エージェントが実行時に参照する CLI コマンドリファレンスです。 - workspace-conventions — エージェントワークスペース内のファイルシステム規約です。

参考資料

• Quickstart — 任意の git リポジトリに対する初回実行ウォークスルーです。
• Architecture — エージェントのライフサイクル、JSON-RPC、ストア、アダプタについて。
• Contributing — テスト、typecheck、コミット規約について。

ライセンス

Apache-2.0 — LICENSE を参照してください。