Claude Code Task list

Claude CodeのTask Listをターミナルで管理する

Claude Code v2.1.16で追加されたTask List機能、使ってますか？

複雑なタスクをClaude Codeに依頼すると、自動的にタスクリストを作成して進捗を管理してくれるこの機能、地味に便利ですよね。

便利だからこそ、もっと自由に使いたくなってきます。

• Claude Codeが作業中でも、別ターミナルで進捗を確認したい
• 手動でタスクを追加・編集したい
• 複数プロジェクトのタスクを横断して見たい

cctasksを作ってもらった

ということで、Task Listを独立して閲覧・編集できるTUIツールをClaude Codeに作ってもらいました。

できること

• プロジェクト一覧: 複数プロジェクトのタスクを切り替え
• タスク一覧: グループ別の折りたたみ表示、ステータス色分け
• フィルタ: ステータス / グループ / キーワードで絞り込み
• タスク操作: 作成・編集・削除・ステータス変更
• グループ管理: グループの作成・編集・並び替え・色設定
• 自動リロード: Claude Codeがタスクを更新したら自動反映

キーボードだけで全操作が完結します。Vimユーザーには馴染みやすい j/k ナビゲーションにも対応。

インストール

go install github.com/jss826/cctasks@latest

または:

git clone https://github.com/jss826/cctasks.git
cd cctasks
go build -o cctasks

使い方

cctasks

起動すると、~/.claude/tasks/ 配下のプロジェクト一覧が表示されます。プロジェクトを選択するとタスク一覧に移動。

主なキーバインド

キー	操作
↑/↓ or j/k	カーソル移動
Enter	選択 / グループ展開
n	新規タスク
e	編集
s	ステータス変更
f	ステータスフィルタ切替
g	グループフィルタ切替
G	グループ管理
/	検索
q	終了

Claude Code側のセットアップ

Task List機能を有効にするには、プロジェクトの .claude/settings.local.json に以下を追加:

{
  "env": {
    "CLAUDE_CODE_TASK_LIST_ID": "your-project-name"
  }
}

これで ~/.claude/tasks/your-project-name/ にタスクが保存されるようになります。

データ形式

タスクは各プロジェクトごとに個別のJSONファイルとして保存されています:

~/.claude/tasks/<project>/
├── 1.json          # タスク
├── 2.json
├── 3.json
└── _groups.json    # グループ設定

各タスクファイル:

{
  "id": "1",
  "subject": "認証機能を実装",
  "description": "JWTベースの認証を追加する",
  "status": "in_progress",
  "blocks": [],
  "blockedBy": [],
  "owner": "",
  "metadata": {
    "group": "Backend"
  }
}

シンプルな構造なので、Claude Code以外のツールとも連携しやすいです。

技術スタック

• Go + Bubble Tea (TUIフレームワーク)
• Lip Gloss (スタイリング)
• カラースキームは Tokyo Night Light

Bubble Teaは The Elm Architecture ベースのTUIフレームワークで、状態管理がシンプルに書けます。Claude Codeに「bubbletea使ってTUI作って」と言えば、いい感じに作ってくれます（実際このツールもほぼClaude Codeが書きました）。

自動リロードの仕組み

Claude Codeがタスクを更新した際、cctasksは自動的に変更を検知して再読み込みします。

// キー入力時にファイルの変更をチェック
if a.taskStore.NeedsReload() {
    a.taskStore, _ = data.LoadTasks(a.projectName)
    // UIを更新
}

ファイルのModTimeを監視しているだけのシンプルな実装です。ポーリングではなく、キー入力をトリガーにしているので余計なリソースを消費しません。

使い分け

シーン	使うツール
Claude Codeに作業を依頼中	Claude Code（自動でタスク管理）
タスク一覧をざっと確認したい	cctasks
手動でタスクを追加・整理したい	cctasks
複数プロジェクトを横断して確認	cctasks

Claude Codeが作業中でも、別ターミナルでcctasksを開いておけば進捗が一目でわかります。

まとめ

Claude CodeのTask List、便利だからこそもっと活用したい。cctasksを使えば、Claude Codeと並行してタスクを自由に閲覧・編集できます。

Go製なのでシングルバイナリで動作し、依存関係もありません。ターミナル派の方はぜひ試してみてください。