ai-devkit

环境要求

• Node.js 环境（可用 npx 执行 CLI）
• 可访问 npm 源，以便拉取 ai-devkit 包
• 本地已安装至少一种受支持的编码代理（如 Claude Code、Codex CLI、Gemini CLI、opencode、Pi、Cursor、GitHub C
• 项目根目录有写权限，用于生成配置文件

安装与启动步骤

1. 1检查 Node 环境

   ai-devkit 通过 npx 运行，先确认本机已安装 Node.js 与 npm，终端可正常调用 npx。

   node -v

   复制

2. 2初始化项目

   在项目根目录执行初始化，按提示选择要接入的编码代理与工作流，生成统一配置。

   npx ai-devkit@latest init

   复制

3. 3查看生成配置

   初始化完成后项目根目录会生成 .ai-devkit.json，可查看或调整已接入的代理与技能。

   cat .ai-devkit.json

   复制

4. 4列出运行会话

   用 agent list 查看各提供商下正在运行的本地代理会话，确认已被识别到。

   ai-devkit agent list

   复制

5. 5打开实时控制台

   agent console 是实时 TUI 面板，用于集中监督跨提供商的本地代理执行情况。

   ai-devkit agent console

   复制

6. 6发送指令给会话

   用 agent send 把提示路由到指定会话，--wait 表示等待该会话返回结果后再退出。

   ai-devkit agent send "run the tests and report back" --id claude-code --wait

   复制

7. 7管道送入长输出

   把测试或构建的多行日志通过标准输入送入运行中的会话，便于代理直接读取。

   npm test 2>&1 | ai-devkit agent send --id claude-code --stdin

   复制

关键配置

如何确认成功

初始化后项目根目录出现 .ai-devkit.json，且执行 ai-devkit agent list 能列出本地运行中的代理会话。

常见问题

注意事项

• README 中的 --id 后需替换为 agent list 里显示的真实会话名，示例中的 claude-code 仅为占位示例。
• 方案为本地优先（local-first），记忆数据存放于本地 SQLite，不上传云端。
• agent console 是交互式 TUI 面板，建议在支持交互的终端中运行，而非重定向输出的脚本环境。
• 项目处于成长阶段，CLI 参数与配置结构可能随版本变化，建议使用 @latest 并关注官方文档 ai-devkit.com。