taskpilot

taskpilot

taskpilot 为 AI 编码 Agent 提供操作任务看板和项目的入口：按编号获取任务、切换任务状态、获取任务对应的提示词、按 slug 或名称查找项目、刷新项目已存储的知识和图表、启动项目、列出看板上的内容，以及询问接下来要处理哪个任务。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

使用时需要 API 密钥；请在使用前设置 CODERIDE_API_KEY。如果未设置或为空，每个工具都会在发出请求前报错。可以通过 TASKPILOT_API_URL 覆盖 API 基础 URL；未设置时，调用会发送到 https://api.coderide.ai。

任务编号是看板上显示的简短代码，例如 TCA-3。任务状态为 to-do、in-progress 或 done。

安装

npx @reneturcios/taskpilot list_projects

也可以运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/taskpilot

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

子命令与 MCP 工具名称一致：

export CODERIDE_API_KEY=...

taskpilot get_task --number TCA-3
taskpilot get_task --number TCA-3 --status in-progress
taskpilot update_task --number TCA-3 --status done
taskpilot update_task --number TCA-3 --description "Revised scope notes"
taskpilot get_prompt --number TCA-3
taskpilot get_project --slug my-app
taskpilot get_project --name "My App"
taskpilot update_project --slug my-app --project-diagram "Web -> API -> DB"
taskpilot update_project --slug my-app --project-knowledge '{"stack":"typescript"}'
taskpilot start_project --slug my-app
taskpilot list_projects
taskpilot list_tasks --slug my-app
taskpilot next_task --number TCA-3

taskpilot --version

结果会输出上游 JSON 载荷。退出码：成功时为 0，调用失败时为 1（包括缺少 API 密钥或上游 API 出错），用法错误时为 2。

MCP 服务

一个二进制文件提供两种形式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/taskpilot mcp

MCP 客户端配置：

{
  "mcpServers": {
    "taskpilot": {
      "command": "npx",
      "args": ["-y", "@reneturcios/taskpilot", "mcp"],
      "env": { "CODERIDE_API_KEY": "..." }
    }
  }
}

工具

工具	输入	功能
get_task	number（必填）、status	按编号获取任务，可选择按状态筛选。
update_task	number（必填）、description、status	更新任务描述和／或状态。
get_prompt	number（必填）	获取任务对应的提示词。
get_project	slug、name	按 slug 或名称获取项目。
update_project	slug（必填）、project_knowledge、project_diagram	更新项目知识和／或图表。
start_project	slug（必填）	启动项目。
list_projects	（无）	列出工作区中的项目。
list_tasks	slug（必填）	列出项目的任务。
next_task	number（必填）	获取指定任务之后的任务。

status 为 to-do、in-progress 或 done。 project_knowledge 是一个 JSON 对象。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。