SynapseAI Forge CLI

这是一个 TypeScript CLI，用来把本机 Codex Runtime 连接到 Agent Runtime Platform 的节点接入端。

本地启动方式

先安装依赖并编译：

npm install
npm run build

启动本地开发平台服务：

node dist/dev-server-index.js --host 127.0.0.1 --port 8787

再打开一个新的终端，启动节点连接：

node dist/index.js connect --server-url http://127.0.0.1:8787 --node-token dev_node_token --runtime codex --cwd .

再打开第三个终端，发送一个测试任务：

node dist/dev-task-index.js --server-url http://127.0.0.1:8787 "请列出项目结构并总结"

命令返回 task_id 后，可以查询任务状态和结果：

curl http://127.0.0.1:8787/tasks/<task_id>

在 PowerShell 中也可以这样查：

Invoke-RestMethod http://127.0.0.1:8787/tasks/<task_id>

任务完成后，本地开发平台所在终端也会直接打印任务输出。

如果你想直接看命令帮助：

node dist/index.js --help
node dist/dev-server-index.js --help
node dist/dev-task-index.js --help

命令说明

agent-runtime connect --server-url http://localhost:8787 --node-token dev_node_token --runtime codex --cwd .
agent-runtime status
agent-runtime logs
agent-runtime-dev-server --host 127.0.0.1 --port 8787
agent-runtime-dev-task "请列出项目结构并总结"

connect 命令始终使用平台 WebSocket 协议。本地调试时使用 agent-runtime-dev-server，它暴露相同的节点连接接口：/provider/nodes/connect。

注意事项

当前版本只支持 codex runtime。真实运行任务时，本机需要能执行 codex 命令，并且 Codex 已完成登录或授权。

平台集成 MVP 演示

完整平台联调请先启动相邻目录里的平台 API：

cd "..\SynapseAI-Forge"
$env:AGENT_RUNTIME_REPOSITORY_MODE = "memory"
$env:AGENT_RUNTIME_DEV_CONSUMER_API_KEY = "sk_consumer_dev"
pnpm --filter @agent-runtime/api dev

然后在本仓库连接 Provider Node：

cd "..\SynapseAI-Forge-CLI"
npm run build
node dist/index.js connect --server-url http://localhost:3000 --agent codex --cwd .

如果本地没有 CLI session，connect 会走浏览器 OAuth mock/dev 登录流程，然后注册 Provider Node 和 Agent，并连接平台 WebSocket。平台侧完整的 API 优先验收步骤见 ..\SynapseAI-Forge\docs\local-demo.md 和 ..\SynapseAI-Forge\docs\mvp-acceptance.md。