wanman-agent-matrix
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesewanman Agent Matrix Runtime
wanman Agent 矩阵运行时
Skill by ara.so — Daily 2026 Skills collection.
wanman is an open-source local agent matrix framework that runs a supervised network of Claude Code or Codex agents on your machine, coordinated through a JSON-RPC supervisor. Inspired by Japanese ワンマン電車 (one-man trains), it lets the human step back into an observer role while agents collaborate autonomously.
由ara.so开发的技能——属于Daily 2026技能合集。
wanman是一款开源本地Agent矩阵框架,可在你的设备上运行由Claude Code或Codex Agent组成的受监督网络,通过JSON-RPC管理器进行协调。它的灵感来源于日本的单人电车(ワンマン電車),能让人类退居观察者角色,同时让Agent自主协作。
Installation & Setup
安装与设置
Prerequisites
前置要求
- Node.js 20+
- pnpm 9+
- git
- A logged-in Claude Code or Codex CLI
- Node.js 20+
- pnpm 9+
- git
- 已登录的Claude Code或Codex CLI
Install from Source
从源码安装
bash
git clone git@github.com:chekusu/wanman.git wanman.dev
cd wanman.dev
pnpm install
pnpm buildbash
git clone git@github.com:chekusu/wanman.git wanman.dev
cd wanman.dev
pnpm install
pnpm buildRun the CLI directly
直接运行CLI
pnpm --filter @wanman/cli exec wanman takeover /path/to/any/git/repo
undefinedpnpm --filter @wanman/cli exec wanman takeover /path/to/any/git/repo
undefinedSingle-file Bundle
单文件打包版
bash
pnpm --filter @wanman/cli standalone
node packages/cli/dist/wanman.mjs takeover /path/to/any/git/repobash
pnpm --filter @wanman/cli standalone
node packages/cli/dist/wanman.mjs takeover /path/to/any/git/repoAdd to PATH
添加到PATH
After building, symlink or alias the CLI so you can run from any project:
wanmanbash
undefined构建完成后,创建符号链接或别名,以便在任意项目中运行:
wanmanbash
undefinedExample: add to PATH via shell profile
示例:通过shell配置文件添加到PATH
export PATH="$PATH:/path/to/wanman.dev/packages/cli/dist"
export PATH="$PATH:/path/to/wanman.dev/packages/cli/dist"
Then from inside any git repo:
之后在任意git仓库内运行:
wanman takeover .
undefinedwanman takeover .
undefinedKey CLI Commands
核心CLI命令
| Command | Description |
|---|---|
| Take over an existing git repo with the full agent matrix |
| Start an agent matrix for a one-shot goal |
| Send a message to an agent ( |
| Receive and mark pending messages as delivered |
| List registered agents and their current states |
| Escalate a message to the CEO agent |
| Live-stream supervisor and agent activity |
| Create a task in the shared pool |
| List all tasks |
| Get task details |
| Update task status/fields |
| Mark a task as complete |
| Create a long-lived initiative |
| List initiatives |
| Create a change capsule |
| List change capsules |
| List capsules owned by current agent |
| Store a structured artifact |
| List stored artifacts |
| Retrieve an artifact |
| Create a hypothesis to track |
| List hypotheses |
| Update hypothesis status |
| Read a shared context value |
| Write a shared context value |
| Validate skill docs reference real CLI commands |
| 命令 | 描述 |
|---|---|
| 使用完整Agent矩阵接管现有git仓库 |
| 为一次性目标启动Agent矩阵 |
| 向指定Agent发送消息( |
| 接收消息并标记为已送达 |
| 列出已注册的Agent及其当前状态 |
| 将消息上报给CEO Agent |
| 实时流式展示管理器与Agent的活动 |
| 在共享任务池中创建任务 |
| 列出所有任务 |
| 获取任务详情 |
| 更新任务状态/字段 |
| 标记任务为已完成 |
| 创建长期任务 |
| 列出所有长期任务 |
| 创建变更胶囊 |
| 列出所有变更胶囊 |
| 列出当前Agent拥有的变更胶囊 |
| 存储结构化工件 |
| 列出已存储的工件 |
| 获取指定工件 |
| 创建待验证假设 |
| 列出所有假设 |
| 更新假设状态 |
| 读取共享上下文值 |
| 写入共享上下文值 |
| 验证技能文档引用的CLI命令是否真实存在 |
Configuration
配置
Environment Variables
环境变量
bash
undefinedbash
undefinedSupervisor HTTP URL for the CLI (default: http://localhost:3120)
CLI连接的管理器HTTP地址(默认:http://localhost:3120)
export WANMAN_URL=http://localhost:3120
export WANMAN_URL=http://localhost:3120
Identifies the current agent (set inside agent processes)
当前Agent的标识(在Agent进程内设置)
export WANMAN_AGENT_NAME=dev
export WANMAN_AGENT_NAME=dev
Select runtime: 'claude' (default) or 'codex'
选择运行时:'claude'(默认)或 'codex'
export WANMAN_RUNTIME=claude
export WANMAN_RUNTIME=claude
Model overrides
模型覆盖配置
export WANMAN_MODEL=claude-opus-4-5
export WANMAN_CODEX_MODEL=o4-mini
export WANMAN_CODEX_REASONING_EFFORT=high
export WANMAN_MODEL=claude-opus-4-5
export WANMAN_CODEX_MODEL=o4-mini
export WANMAN_CODEX_REASONING_EFFORT=high
Bias Codex adapter toward lower-latency defaults
让Codex适配器偏向低延迟默认配置
export WANMAN_CODEX_FAST=1
export WANMAN_CODEX_FAST=1
Override where runtime materializes skill-activation snapshots
覆盖运行时存储技能激活快照的目录
export WANMAN_SKILL_SNAPSHOTS_DIR=/tmp/my-skill-snapshots
undefinedexport WANMAN_SKILL_SNAPSHOTS_DIR=/tmp/my-skill-snapshots
undefinedAgent Configuration File
Agent配置文件
Agent definitions live in a single JSON file (typically ):
.wanman/config.jsonjson
{
"agents": [
{
"name": "ceo",
"lifecycle": "24/7",
"model": "high",
"systemPrompt": "You are the CEO agent. Coordinate all other agents, prioritize tasks, and escalate blockers."
},
{
"name": "dev",
"lifecycle": "on-demand",
"model": "standard",
"systemPrompt": "You are the dev agent. Implement features, fix bugs, and write tests."
},
{
"name": "devops",
"lifecycle": "on-demand",
"model": "standard",
"systemPrompt": "You are the devops agent. Manage CI/CD, infrastructure, and deployments."
},
{
"name": "researcher",
"lifecycle": "idle_cached",
"model": "standard",
"systemPrompt": "You are the research agent. Gather market data and synthesize findings."
}
],
"dbPath": ".wanman/wanman.db",
"port": 3120,
"workspaceRoot": ".wanman/agents"
}Agent定义存储在单个JSON文件中(通常为):
.wanman/config.jsonjson
{
"agents": [
{
"name": "ceo",
"lifecycle": "24/7",
"model": "high",
"systemPrompt": "你是CEO Agent。负责协调所有其他Agent,确定任务优先级,并上报阻塞问题。"
},
{
"name": "dev",
"lifecycle": "on-demand",
"model": "standard",
"systemPrompt": "你是开发Agent。负责实现功能、修复Bug并编写测试。"
},
{
"name": "devops",
"lifecycle": "on-demand",
"model": "standard",
"systemPrompt": "你是DevOps Agent。负责管理CI/CD、基础设施和部署工作。"
},
{
"name": "researcher",
"lifecycle": "idle_cached",
"model": "standard",
"systemPrompt": "你是研究Agent。负责收集市场数据并整合研究结果。"
}
],
"dbPath": ".wanman/wanman.db",
"port": 3120,
"workspaceRoot": ".wanman/agents"
}Agent Lifecycle Options
Agent生命周期选项
- — Continuous respawn loop; agent always running.
24/7 - — Idle until triggered by a message or task.
on-demand - — Idle until triggered, but preserves Claude
idle_cachedacross triggers viasession_id. Claude-only — pairing withclaude --resumeruntime is rejected at startup.codex
- — 持续重启循环;Agent始终处于运行状态。
24/7 - — 闲置状态,直到被消息或任务触发。
on-demand - — 闲置状态,直到被触发,但通过
idle_cached保留Claude的claude --resume。仅支持Claude — 与codex运行时搭配会在启动时被拒绝。session_id
Model Tiers
模型层级
- — Maps to highest-capability model for the selected runtime.
high - — Maps to balanced default model; overridable via
standardorWANMAN_MODEL.WANMAN_CODEX_MODEL
- — 映射为所选运行时中能力最强的模型。
high - — 映射为平衡的默认模型;可通过
standard或WANMAN_MODEL覆盖。WANMAN_CODEX_MODEL
Architecture Overview
架构概述
+----------------+ +--------------------+ +-----------------+
| 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 |
+--------------------+ +-----------------+- The CLI communicates with the Supervisor via JSON-RPC 2.0 over HTTP.
- The Supervisor owns: message store, context store, task pool, artifact store, and spawns child agent processes.
- Each agent runs in an isolated per-agent worktree and per-agent , so agents never mutate your working directory or shell profile.
$HOME
+----------------+ +--------------------+ +-----------------+
| 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 |
+--------------------+ +-----------------+- CLI通过HTTP上的JSON-RPC 2.0与管理器通信。
- 管理器负责:消息存储、上下文存储、任务池、工件存储,并启动子Agent进程。
- 每个Agent运行在独立的专属工作树和专属目录中,因此Agent不会修改你的工作目录或shell配置。
$HOME
Common Patterns & Workflows
常见模式与工作流
Pattern 1: Take Over an Existing Repo
模式1:接管现有仓库
bash
undefinedbash
undefinedFrom inside the repo you want agents to work on:
进入你希望Agent处理的仓库:
cd /path/to/my-project
wanman takeover .
cd /path/to/my-project
wanman takeover .
Watch the agents coordinate in real time:
实时监控Agent的协作过程:
wanman watch
undefinedwanman watch
undefinedPattern 2: Send a Goal and Monitor Progress
模式2:发送目标并监控进度
bash
undefinedbash
undefinedLaunch agents against a specific goal
针对特定目标启动Agent
wanman run "Refactor the authentication module to use JWT tokens"
wanman run "重构认证模块以使用JWT令牌"
In another terminal, watch activity stream
在另一个终端中,查看活动流
wanman watch
wanman watch
Check agent states
检查Agent状态
wanman agents
wanman agents
Escalate to CEO if blocked
如果遇到阻塞,上报给CEO Agent
wanman escalate "Dev agent is stuck on the JWT library choice, please decide"
undefinedwanman escalate "开发Agent在选择JWT库时陷入困境,请决策"
undefinedPattern 3: Inter-Agent Messaging
模式3:Agent间消息传递
bash
undefinedbash
undefinedSend a normal message to the dev agent
向开发Agent发送普通消息
wanman send dev "Please add unit tests for the UserService class"
wanman send dev "请为UserService类添加单元测试"
Send a steering (interrupt) message to the dev agent
向开发Agent发送引导(中断)消息
wanman send dev --steer "STOP current task. Critical bug in auth — fix login endpoint first"
wanman send dev --steer "停止当前任务。认证模块存在严重Bug——优先修复登录端点"
Receive messages as the dev agent
以开发Agent身份接收消息
WANMAN_AGENT_NAME=dev wanman recv
WANMAN_AGENT_NAME=dev wanman recv
Receive all pending messages for any agent
接收所有Agent的待处理消息
wanman recv
undefinedwanman recv
undefinedPattern 4: Task Pool Management
模式4:任务池管理
bash
undefinedbash
undefinedCreate a task with a dependency on task ID abc123
创建依赖于任务ID abc123的新任务
wanman task create
--title "Write integration tests"
--description "Cover all API endpoints with integration tests"
--agent dev
--after abc123
--title "Write integration tests"
--description "Cover all API endpoints with integration tests"
--agent dev
--after abc123
wanman task create
--title "编写集成测试"
--description "为所有API端点编写集成测试"
--agent dev
--after abc123
--title "编写集成测试"
--description "为所有API端点编写集成测试"
--agent dev
--after abc123
List all tasks and their statuses
列出所有任务及其状态
wanman task list
wanman task list
Get details of a specific task
获取特定任务的详情
wanman task get <task-id>
wanman task get <task-id>
Update task status
更新任务状态
wanman task update <task-id> --status in-progress
wanman task update <task-id> --status in-progress
Mark complete
标记任务为完成
wanman task done <task-id>
undefinedwanman task done <task-id>
undefinedPattern 5: Shared Context Store
模式5:共享上下文存储
bash
undefinedbash
undefinedStore shared context accessible to all agents
存储所有Agent均可访问的共享上下文
wanman context set api_base_url "https://api.example.com/v2"
wanman context set target_environment "staging"
wanman context set api_base_url "https://api.example.com/v2"
wanman context set target_environment "staging"
Read context values
读取上下文值
wanman context get api_base_url
wanman context get api_base_url
Agents read context in their prompts automatically via the supervisor
Agent会通过管理器自动在提示词中读取上下文
undefinedundefinedPattern 6: Artifact Storage
模式6:工件存储
bash
undefinedbash
undefinedStore a structured artifact (e.g., research output)
存储结构化工件(例如研究成果)
wanman artifact put
--name "market-analysis-q2"
--type "report"
--content "$(cat analysis.md)"
--name "market-analysis-q2"
--type "report"
--content "$(cat analysis.md)"
wanman artifact put
--name "q2市场分析"
--type "报告"
--content "$(cat analysis.md)"
--name "q2市场分析"
--type "报告"
--content "$(cat analysis.md)"
List artifacts
列出所有工件
wanman artifact list
wanman artifact list
Retrieve a specific artifact
获取特定工件
wanman artifact get <artifact-id>
undefinedwanman artifact get <artifact-id>
undefinedPattern 7: Hypothesis Tracking
模式7:假设跟踪
bash
undefinedbash
undefinedCreate a hypothesis for agents to validate
创建供Agent验证的假设
wanman hypothesis create
--title "Switching to Bun runtime reduces build time by 40%"
--description "Based on benchmarks from similar TypeScript projects"
--title "Switching to Bun runtime reduces build time by 40%"
--description "Based on benchmarks from similar TypeScript projects"
wanman hypothesis create
--title "切换到Bun运行时可将构建时间减少40%"
--description "基于类似TypeScript项目的基准测试结果"
--title "切换到Bun运行时可将构建时间减少40%"
--description "基于类似TypeScript项目的基准测试结果"
List hypotheses and their validation status
列出所有假设及其验证状态
wanman hypothesis list
wanman hypothesis list
Update after validation
验证后更新状态
wanman hypothesis update <id> --status confirmed --evidence "Build time dropped from 45s to 26s"
undefinedwanman hypothesis update <id> --status confirmed --evidence "构建时间从45秒降至26秒"
undefinedPattern 8: Change Capsules
模式8:变更胶囊
bash
undefinedbash
undefinedCreate a change capsule (bounded unit of work/change)
创建变更胶囊(有界的工作/变更单元)
wanman capsule create
--title "Auth JWT migration"
--description "Migrate session-based auth to JWT"
--title "Auth JWT migration"
--description "Migrate session-based auth to JWT"
wanman capsule create
--title "认证JWT迁移"
--description "将基于会话的认证迁移为JWT认证"
--title "认证JWT迁移"
--description "将基于会话的认证迁移为JWT认证"
List all capsules
列出所有变更胶囊
wanman capsule list
wanman capsule list
List capsules owned by the current agent
列出当前Agent拥有的变更胶囊
WANMAN_AGENT_NAME=dev wanman capsule mine
WANMAN_AGENT_NAME=dev wanman capsule mine
Get details
获取详情
wanman capsule get <capsule-id>
undefinedwanman capsule get <capsule-id>
undefinedTypeScript Integration (Host SDK)
TypeScript集成(Host SDK)
Embed wanman into your own tools using the package:
@wanman/host-sdktypescript
import { WanmanClient } from '@wanman/host-sdk';
// Connect to a running supervisor
const client = new WanmanClient({
url: process.env.WANMAN_URL ?? 'http://localhost:3120',
});
// Send a message programmatically
await client.send({
agent: 'dev',
message: 'Please review the PR and add inline comments',
steer: false,
});
// Create a task
const task = await client.task.create({
title: 'Fix flaky tests',
description: 'Tests in auth.test.ts fail intermittently under CI',
agent: 'dev',
});
// Poll for agent status
const agents = await client.agents.list();
for (const agent of agents) {
console.log(`${agent.name}: ${agent.state}`);
}
// Store an artifact
await client.artifact.put({
name: 'perf-baseline',
type: 'benchmark',
content: JSON.stringify(perfResults),
});
// Read shared context
const env = await client.context.get('target_environment');使用包将wanman嵌入你自己的工具:
@wanman/host-sdktypescript
import { WanmanClient } from '@wanman/host-sdk';
// 连接到运行中的管理器
const client = new WanmanClient({
url: process.env.WANMAN_URL ?? 'http://localhost:3120',
});
// 以编程方式发送消息
await client.send({
agent: 'dev',
message: '请审核PR并添加行内注释',
steer: false,
});
// 创建任务
const task = await client.task.create({
title: '修复不稳定测试',
description: 'auth.test.ts中的测试在CI环境下间歇性失败',
agent: 'dev',
});
// 轮询Agent状态
const agents = await client.agents.list();
for (const agent of agents) {
console.log(`${agent.name}: ${agent.state}`);
}
// 存储工件
await client.artifact.put({
name: '性能基准',
type: '基准测试',
content: JSON.stringify(perfResults),
});
// 读取共享上下文
const env = await client.context.get('target_environment');Project Structure
项目结构
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/
quickstart.md
architecture.md
CONTRIBUTING.mdwanman.dev/
packages/
cli/ # wanman CLI(send/recv/task/artifact/run/takeover/...)
core/ # 共享类型、JSON-RPC协议、技能(core/skills/)
host-sdk/ # 用于将wanman嵌入其他工具的Host端SDK
runtime/ # 管理器、Agent进程管理器、SQLite存储、适配器
docs/
quickstart.md
architecture.md
CONTRIBUTING.mdBuilt-in Shared Skills (packages/core/skills/
)
packages/core/skills/内置共享技能(packages/core/skills/
)
packages/core/skills/Skills are auto-discovered by agents at :
~/.claude/skills/- — Conventions for naming agent-produced artifacts.
artifact-naming - — Quality standards for artifacts.
artifact-quality - — CEO consistency checks across agent outputs.
cross-validation - — Market/data research methodology.
research-methodology - — CLI command reference consumed by agents at runtime.
wanman-cli - — File-system conventions inside agent workspaces.
workspace-conventions
Agent会自动发现目录下的技能:
~/.claude/skills/- — Agent生成工件的命名规范。
artifact-naming - — 工件质量标准。
artifact-quality - — CEO Agent对多个Agent输出的一致性检查。
cross-validation - — 市场/数据研究方法。
research-methodology - — Agent运行时使用的CLI命令参考。
wanman-cli - — Agent工作区内的文件系统规范。
workspace-conventions
Validate Skills
验证技能
bash
undefinedbash
undefinedCheck that skill docs only reference real CLI commands
检查技能文档是否仅引用真实存在的CLI命令
wanman skill:check
wanman skill:check packages/core/skills/wanman-cli.md
undefinedwanman skill:check
wanman skill:check packages/core/skills/wanman-cli.md
undefinedTesting
测试
bash
undefinedbash
undefinedType checking
类型检查
pnpm typecheck
pnpm typecheck
Run all tests
运行所有测试
pnpm test
pnpm test
Run tests with coverage (target: 90%+ line coverage)
运行测试并生成覆盖率报告(目标:90%+行覆盖率)
pnpm exec vitest run
--coverage
--coverage.reporter=text-summary
--coverage.reporter=json-summary
--coverage.exclude='/dist/'
--coverage
--coverage.reporter=text-summary
--coverage.reporter=json-summary
--coverage.exclude='/dist/'
pnpm exec vitest run
--coverage
--coverage.reporter=text-summary
--coverage.reporter=json-summary
--coverage.exclude='/dist/'
--coverage
--coverage.reporter=text-summary
--coverage.reporter=json-summary
--coverage.exclude='/dist/'
Coverage summary written to: coverage/coverage-summary.json
覆盖率摘要将写入:coverage/coverage-summary.json
undefinedundefinedTroubleshooting
故障排除
Supervisor Not Reachable
无法连接管理器
bash
undefinedbash
undefinedCheck if supervisor is running on expected port
检查管理器是否在预期端口运行
Override URL if running on a non-default port
如果管理器运行在非默认端口,覆盖URL配置
export WANMAN_URL=http://localhost:4000
wanman agents
undefinedexport WANMAN_URL=http://localhost:4000
wanman agents
undefinedAgent Stuck / Not Responding
Agent卡住/无响应
bash
undefinedbash
undefinedCheck agent states
检查Agent状态
wanman agents
wanman agents
Send a steer message to interrupt and redirect
发送引导消息中断并重置Agent
wanman send <agent-name> --steer "Reset and await new instructions"
wanman send <agent-name> --steer "重置并等待新指令"
Escalate to CEO for intervention
上报给CEO Agent进行干预
wanman escalate "Agent 'dev' appears stuck on task <task-id>, please reassign"
wanman escalate "Agent 'dev'在处理任务<task-id>时似乎卡住,请重新分配"
Watch live activity to diagnose
查看实时活动以诊断问题
wanman watch
undefinedwanman watch
undefinedidle_cached
Lifecycle with Wrong Runtime
idle_cachedidle_cached
生命周期与错误运行时搭配
idle_cachedError: idle_cached lifecycle requires Claude runtime; codex has no resume mechanismFix: Only use when (or unset, as Claude is the default). Switch lifecycle to for Codex agents.
lifecycle: "idle_cached"WANMAN_RUNTIME=claudeon-demandError: idle_cached lifecycle requires Claude runtime; codex has no resume mechanism修复方案: 仅当(或未设置,因为Claude是默认值)时使用。对于Codex Agent,请将生命周期切换为。
WANMAN_RUNTIME=claudelifecycle: "idle_cached"on-demandAgents Mutating Wrong Directory
Agent修改错误目录
Each agent runs in its own git worktree under (default: ). If an agent appears to be modifying wrong files, check in your config and ensure is set correctly in agent subprocesses.
workspaceRoot.wanman/agents/workspaceRootWANMAN_AGENT_NAME每个Agent运行在(默认:)下的专属git工作树中。如果Agent似乎在修改错误文件,请检查配置中的,并确保Agent子进程中正确设置了。
workspaceRoot.wanman/agents/workspaceRootWANMAN_AGENT_NAMESQLite Lock Errors
SQLite锁错误
If the supervisor crashes mid-run, the SQLite file at may be locked:
dbPathbash
undefined如果管理器在运行中途崩溃,对应的SQLite文件可能会被锁定:
dbPathbash
undefinedStop all wanman processes
停止所有wanman进程
pkill -f wanman
pkill -f wanman
Remove WAL files if present
如果存在WAL文件,将其删除
rm .wanman/wanman.db-wal .wanman/wanman.db-shm
rm .wanman/wanman.db-wal .wanman/wanman.db-shm
Restart supervisor
重启管理器
wanman takeover .
undefinedwanman takeover .
undefinedSkill Validation Failures
技能验证失败
bash
undefinedbash
undefinedRun skill:check to find references to non-existent commands
运行skill:check查找引用不存在命令的内容
wanman skill:check
wanman skill:check
Output will show which skill files reference invalid commands
输出会显示哪些技能文件引用了无效命令
Update the skill markdown to use only real wanman CLI commands
更新技能markdown文件,仅使用真实存在的wanman CLI命令
undefinedundefinedFurther Reading
扩展阅读
- Quickstart Guide — First-run walkthrough against any git repo.
- Architecture Deep Dive — Agent lifecycle, JSON-RPC, stores, adapters, brain/persistence.
- Contributing Guide — Tests, typecheck, commit conventions.
- wanman.ai — Hosted 24/7 sandbox edition with dynamic roles and global search.
- 快速入门指南 — 针对任意git仓库的首次运行教程。
- 架构深度解析 — Agent生命周期、JSON-RPC、存储、适配器、核心逻辑/持久化。
- 贡献指南 — 测试、类型检查、提交规范。
- wanman.ai — 托管式24/7沙箱版本,支持动态角色与全局搜索。