{"id":49797238,"url":"https://github.com/chekusu/wanman","last_synced_at":"2026-05-12T12:12:18.400Z","repository":{"id":353174744,"uuid":"1218088263","full_name":"chekusu/wanman","owner":"chekusu","description":"wanman is an open-source agent matrix runtime inspired by Japanese one-man trains. It lets human users step back into an observer role while local agent runtimes coordinate autonomous multi-agent workflows, task execution, and artifacts.","archived":false,"fork":false,"pushed_at":"2026-04-22T18:47:46.000Z","size":641,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T20:20:42.298Z","etag":null,"topics":["agent","claude-code","codex","llm"],"latest_commit_sha":null,"homepage":"http://wanman.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chekusu.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":"CONTRIBUTING.ja.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T14:17:57.000Z","updated_at":"2026-04-22T18:52:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chekusu/wanman","commit_stats":null,"previous_names":["chekusu/wanman"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chekusu/wanman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chekusu%2Fwanman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chekusu%2Fwanman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chekusu%2Fwanman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chekusu%2Fwanman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chekusu","download_url":"https://codeload.github.com/chekusu/wanman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chekusu%2Fwanman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32938217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T09:19:52.626Z","status":"ssl_error","status_checked_at":"2026-05-12T09:17:33.438Z","response_time":102,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","claude-code","codex","llm"],"created_at":"2026-05-12T12:12:13.338Z","updated_at":"2026-05-12T12:12:18.384Z","avatar_url":"https://github.com/chekusu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wanman\n\n[English](README.md) | [中文](README.zh.md) | **日本語**\n\nAgent Matrix フレームワーク — 監督下の Claude Code あるいは Codex エージェントのネットワークを起動し、あなたのマシン上で協調動作させます。\n\nwanman はオープンソースのローカルモード Agent Matrix フレームワークです。監督下の Claude Code あるいは Codex エージェントのネットワークをあなたのマシン上で動かし、JSON-RPC スーパーバイザーを介して協調動作させます。\n\n## wanman について\n\nwanman という名前は、日本語の [ワンマン電車 / one-man train](https://en.wikipedia.org/wiki/One-person_operation) に由来します。車掌なしで 1 人の運転士が運行する電車です。wanman の設計目標もこのイメージに近く、人間のユーザーが観察者の役割に退き、agent matrix が自動実行される様子を全方位から観察できるようにすることです。\n\n[wanman.ai](https://wanman.ai/) は、wanman の完全自動 24/7 サンドボックス版を提供しています。これは [Sandbank Cloud](https://cloud.sandbank.dev/) のサンドボックスクラウド上で完全無料で動作します。\n\n## 何をするか\n\n- 複数のエージェント（CEO、dev、devops、marketing、feedback など）を、steer/follow-up 優先度付きの非同期メッセージバスで連携させます。\n- 各エージェントを実際の Claude Code または Codex CLI サブプロセスとして実行します。CLI 認証はあなた自身のものを利用し、wanman は spawn、プロンプト送出、ライフサイクルを統括します。\n- すべてのエージェントをエージェントごとのワークツリーとエージェントごとの `$HOME` で隔離するため、エージェントがあなたの汚れた作業コピーやシェルプロファイルを変更することはありません。\n- CLI ファーストです。すべてが `wanman` コマンドと JSON-RPC スーパーバイザー経由でスクリプト化可能、観測可能、再現可能です。\n\n[wanman.ai](https://wanman.ai/) は、ホステッド版だけの機能も提供します:\n- 各 agent runtime グループを個別の sandbox 環境に隔離し、大規模・高並行のタスク実行をサポートします。\n- agents の役割を動的に設定し、インターネット上の優れた agent 役割カタログから役割を自動抽出できます。\n- 動的な skill の自己進化をサポートします。\n- db9 によるグローバル検索とストーリー検索をサポートします。\n\n## Quickstart\n\n```bash\n# 前提条件: Node 20+, pnpm 9+, git, ログイン済みの Claude Code または Codex CLI。\ngit clone git@github.com:chekusu/wanman.git wanman.dev\ncd wanman.dev\npnpm install\npnpm build\n\n# ソースから直接実行します。npm package の公開は不要です。\npnpm --filter @wanman/cli exec wanman takeover /path/to/any/git/repo\n```\n\n単一ファイルの CLI bundle が必要な場合:\n\n```bash\npnpm --filter @wanman/cli standalone\nnode packages/cli/dist/wanman.mjs takeover /path/to/any/git/repo\n```\n\n`wanman` がすでに `PATH` にある場合は、対象リポジトリ内で `wanman takeover .` を直接実行できます。\n\n完全な手順は [`docs/quickstart.ja.md`](docs/quickstart.ja.md) を参照してください。\n\n## CLI コマンド\n\n| コマンド | 用途 |\n|---------|--------------|\n| `wanman send \u003cagent\u003e \u003cmsg\u003e` | エージェントにメッセージを送信します（`--steer` は対象を中断します）。 |\n| `wanman recv [--agent \u003cname\u003e]` | 保留中のメッセージを受信し、配信済みとしてマークします。 |\n| `wanman agents` | 登録済みエージェントと現在の状態を一覧表示します。 |\n| `wanman context get` / `context set` | 共有の key/value コンテキストを読み書きします。 |\n| `wanman escalate \u003cmsg\u003e` | CEO エージェントにエスカレーションします。 |\n| `wanman task …` | タスクプールを管理します: `create`、`list`、`get`、`update`、`done`。`--after` による依存関係もサポートします。 |\n| `wanman initiative …` | 長期的な initiative を管理します: `create`、`list`、`get`、`update`。 |\n| `wanman capsule …` | 変更 capsule を管理します: `create`、`list`、`mine`、`get`、`update`。 |\n| `wanman artifact …` | 構造化された artifact を保存・取得します: `put`、`list`、`get`。 |\n| `wanman hypothesis …` | 状態遷移付きで hypothesis を追跡します: `create`、`list`、`update`。 |\n| `wanman watch` | スーパーバイザーとエージェントの活動をライブ配信します。 |\n| `wanman run \u003cgoal\u003e` | 単発ゴールに対して matrix を起動します。 |\n| `wanman takeover \u003cpath\u003e` | 既存の git リポジトリを完全な agent matrix で引き継ぎます。 |\n| `wanman skill:check [path]` | skill ドキュメントが実在の CLI コマンドのみを参照しているか検証します。 |\n\n最新の完全なリストは `wanman --help` を実行して確認してください。\n\n## アーキテクチャ\n\n```\n+----------------+          +--------------------+          +-----------------+\n|  wanman CLI    |  JSON    |  Supervisor        |  spawn   |  Agent process  |\n|  (host shell)  | ---RPC--\u003e|  (local process)   | -------\u003e |  (Claude/Codex) |\n|                |  /rpc    |  message/context/  |          |  per-agent $HOME|\n|                |          |  task/artifact     |          |  per-agent wt   |\n+----------------+          +--------------------+          +-----------------+\n                                    |                              |\n                                    v                              v\n                           +--------------------+        +-----------------+\n                           |  files + SQLite    |        |  worktree       |\n                           +--------------------+        +-----------------+\n```\n\n- `wanman \u003csubcommand\u003e` は Supervisor プロセスに対して JSON-RPC 2.0 で通信します。\n- Supervisor は message store、context store、task pool、artifact store を保有し、エージェントごとに 1 つの子プロセスを spawn します。\n- 各エージェントの子プロセスはローカルの Claude Code または Codex サブプロセスで、エージェントごとのワークツリーと隔離された `$HOME` に紐付いています。\n\n詳細: [`docs/architecture.ja.md`](docs/architecture.ja.md)。\n\n## 設定\n\n| 環境変数 | 意味 |\n|---------|---------|\n| `WANMAN_URL` | CLI 向けの Supervisor HTTP URL（デフォルト `http://localhost:3120`）。 |\n| `WANMAN_AGENT_NAME` | 現在のエージェントを識別します。エージェントプロセス内で既定の送信者/受信者として使われます。 |\n| `WANMAN_RUNTIME` | `claude`（デフォルト）または `codex` — エージェントごとの CLI アダプタを選択します。 |\n| `WANMAN_MODEL`, `WANMAN_CODEX_MODEL`, `WANMAN_CODEX_REASONING_EFFORT` | runtime ごとのモデル上書き設定です。 |\n| `WANMAN_CODEX_FAST` | 設定すると Codex アダプタを低レイテンシ寄りのデフォルトに傾けます。 |\n| `WANMAN_SKILL_SNAPSHOTS_DIR` | runtime が skill 有効化スナップショットを展開する場所を上書きします（デフォルトは shared-skills ディレクトリの兄弟、フォールバックは `$TMPDIR/wanman-skill-snapshots`）。 |\n\nクロスラン記憶のために、オプションで `@sandbank.dev/db9` brain アダプタを接続できます — [`docs/architecture.ja.md`](docs/architecture.ja.md#brain--persistence) を参照してください。\n\n## エージェント設定\n\nエージェントの定義は単一の JSON ファイルに記述します:\n\n```json\n{\n  \"agents\": [\n    { \"name\": \"echo\", \"lifecycle\": \"24/7\", \"model\": \"standard\", \"systemPrompt\": \"...\" },\n    { \"name\": \"ping\", \"lifecycle\": \"on-demand\", \"model\": \"standard\", \"systemPrompt\": \"...\" }\n  ],\n  \"dbPath\": \".wanman/wanman.db\",\n  \"port\": 3120,\n  \"workspaceRoot\": \".wanman/agents\"\n}\n```\n\nエージェントエントリごとに以下のフィールドがあります:\n- `name` — メッセージバス上で使われる一意識別子です。\n- `lifecycle` — `24/7`（連続再生成ループ）または `on-demand`（トリガーがあるまでアイドル）。\n- `model` — 通常は抽象 tier（`high` または `standard`）を使います。runtime アダプタが Claude または Codex のデフォルトモデルに解決し、環境変数で上書きできます。\n- `systemPrompt` — 組み込みのペルソナ/ミッションです。エージェントは `~/.claude/skills/` にある共有 skill ファイルも自動検出します。\n- オプションの `cron`、`events`、`tools` フィールド — 完全なスキーマは architecture ドキュメントを参照してください。\n\n## Testing\n\n```bash\npnpm typecheck\npnpm test\npnpm exec vitest run --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary --coverage.exclude='**/dist/**'\n```\n\n現在のカバレッジ目標は、行カバレッジ 90% 以上です。直近のローカル検証では `Lines: 90.17%` でした。機械可読のサマリーは `coverage/coverage-summary.json` に出力されます。\n\n## プロジェクト構造\n\n```\nwanman.dev/\n  packages/\n    cli/                 wanman CLI (send/recv/task/artifact/run/takeover/...)\n    core/                Shared types, JSON-RPC protocol, skills (core/skills/)\n    host-sdk/            Host-side SDK for embedding wanman into other tools\n    runtime/             Supervisor, agent process manager, SQLite stores, adapters\n  docs/                  Architecture and quickstart guides\n```\n\n現在同梱されている共有 skill（`packages/core/skills/`）:\n- `artifact-naming`, `artifact-quality` — エージェントが生成する artifact の規約です。\n- `cross-validation` — CEO によるエージェント出力の整合性チェックです。\n- `research-methodology` — マーケット/データ調査の方法論です。\n- `wanman-cli` — エージェントが実行時に参照する CLI コマンドリファレンスです。\n- `workspace-conventions` — エージェントワークスペース内のファイルシステム規約です。\n\n## 参考資料\n\n- [Quickstart](docs/quickstart.ja.md) — 任意の git リポジトリに対する初回実行ウォークスルーです。\n- [Architecture](docs/architecture.ja.md) — エージェントのライフサイクル、JSON-RPC、ストア、アダプタについて。\n- [Contributing](CONTRIBUTING.ja.md) — テスト、typecheck、コミット規約について。\n\n## ライセンス\n\nApache-2.0 — [LICENSE](LICENSE) を参照してください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchekusu%2Fwanman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchekusu%2Fwanman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchekusu%2Fwanman/lists"}