cbc-it-here

全局 Node.js CLI 工具，在任意项目目录下读取 task.md 文件，通过 CodeBuddy Agent SDK 自动执行任务。

功能特性

• 读取当前目录 task.md 作为任务描述，自动提交给 CodeBuddy AI 代理执行
• 支持批量执行 task/task{id}.md 文件，按顺序执行多个任务
• 流式实时输出 AI 回复内容
• 执行完成后显示耗时和费用
• 以自动授权模式运行，无需手动确认
• 支持配置文件自定义执行选项

前置条件

• Node.js >= 18（需要 ES Module 和 async iterator 支持）
• 已配置 CodeBuddy API Key 环境变量

安装

pnpm add -g cbc-it-here

或使用 npm/yarn：

npm install -g cbc-it-here
yarn global add cbc-it-here

使用说明

方式一：单个任务文件

1. 在项目根目录创建 task.md

使用 Markdown checkbox 列表格式编写任务：

- [ ] 将现在时间写入当前目录time4.txt
- [ ] 将现在时间写入当前目录time5.txt
- [ ] 将现在时间写入当前目录time6.txt

2. 运行命令

cbc-it

方式二：批量执行多个任务

1. 创建 task 目录并添加多个任务文件

在项目根目录创建 task 目录，并添加 task1.md、task2.md 等文件：

project/
├── task/
│   ├── task1.md
│   ├── task2.md
│   └── task3.md
└── ...

工具将按数字顺序依次执行 task1.md、task2.md、task3.md...

2. 运行命令

cbc-it

工具会输出每个任务的执行进度：

========== 执行 task1.md ==========
... AI 输出 ...
完成！耗时： 1805 ms
费用： 0 USD

========== 执行 task2.md ==========
... AI 输出 ...
完成！耗时： 1234 ms
费用： 0 USD

（可选）创建配置文件

在项目根目录创建配置文件来自定义行为。支持以下文件名（按优先级排序）：

• .cbc-it.json
• .cbc-it.js
• cbc-it.config.js
• cbc-it.config.json

JSON 配置示例 (.cbc-it.json):

{
  "options": {
    "permissionMode": "bypassPermissions"
  }
}

JS 配置示例 (.cbc-it.js):

export default {
  options: {
    permissionMode: 'bypassPermissions'
  }
}

如未创建配置文件，将使用默认配置（permissionMode: 'bypassPermissions'）。

查看输出

工具会流式输出 AI 代理的回复文本，任务完成后显示：

完成！耗时：xxxx ms
费用：x.xxxx USD

工作原理

1. 检查当前目录是否存在 task.md 文件或 task/ 目录及 task{id}.md 文件
2. 读取任务文件内容
3. 调用 CodeBuddy Agent SDK 的 query() 方法，将任务提交给 AI 代理
4. 批量模式下，按数字顺序依次执行任务（task1.md、task2.md 等）
5. 以 bypassPermissions 模式运行，AI 代理自动获得操作权限
6. 流式接收并输出 AI 代理的回复内容
7. 每个任务完成后输出耗时（毫秒）和费用（美元）

许可证

CC BY 4.0