taskpilot

taskpilot

taskpilot を使うと、AI コーディングエージェントからタスクボードやプロジェクトを操作できます。番号を指定してタスクを取得したり、ステータスを変更したり、タスクに紐づくプロンプトを取得したりできます。また、スラッグや名前でプロジェクトを検索したり、プロジェクトに保存されたナレッジや図を更新したり、プロジェクトを開始したり、ボード上の項目を一覧表示したり、次のタスクを確認したりできます。1 つのバイナリでコマンドラインインターフェースと stdio MCP サーバーを提供します。

API キーが必要です。使用前に CODERIDE_API_KEY を設定してください。未設定または空白の場合、リクエストを送信する前にすべてのツールがエラーになります。API のベース URL は TASKPILOT_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、呼び出し失敗時（API キーの未設定や上流 API エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方の機能を提供します。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	スラッグまたは名前でプロジェクトを取得します。
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 を参照してください。