Taskpilot

taskpilot

taskpilot gives AI coding agents a handle on their task board and their projects: fetch a task by its number, move it between statuses, pull the prompt that belongs to it, look projects up by slug or name, refresh a project's stored knowledge and diagram, start a project, list what is on the board, and ask which task comes next. One binary serves a command-line interface and a stdio MCP server.

An API key is required. Set CODERIDE_API_KEY before use; when it is missing or blank, every tool fails with an error before any request is made. The API base URL can be overridden with TASKPILOT_API_URL; when it is not set, calls go to https://api.coderide.ai.

Task numbers are the short human codes shown on the board, for example TCA-3. A task's status is one of to-do, in-progress, or done.

Install

npx @reneturcios/taskpilot list_projects

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/taskpilot

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

The subcommands mirror the MCP tool names:

export CODERIDE_API_KEY=...
taskpilot get_task --number TCA-3taskpilot get_task --number TCA-3 --status in-progresstaskpilot update_task --number TCA-3 --status donetaskpilot update_task --number TCA-3 --description "Revised scope notes"taskpilot get_prompt --number TCA-3taskpilot get_project --slug my-apptaskpilot 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-apptaskpilot list_projectstaskpilot list_tasks --slug my-apptaskpilot next_task --number TCA-3
taskpilot --version

Results print the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing API key or an upstream API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/taskpilot mcp

MCP client configuration:

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

Tools

status is one of to-do, in-progress, done. project_knowledge is a JSON object.

Development

npm installnpm 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

License

MIT — see LICENSE.