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

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

License

MIT — see LICENSE.