cctasks

cctasks

Claude Code の Task List 機能で作成されたタスクを閲覧・編集できる TUI ツール。

Features

• プロジェクト一覧表示・選択
• タスク一覧（グループ別折りたたみ表示）
• ステータス / グループ / キーワードフィルタ
• 完了タスク非表示トグル
• ソート機能（ID順 / ステータス順）
• タスク作成・編集・削除
• ステータスのクイック変更
• 依存関係（Blocks / BlockedBy）の編集・タスク検索ピッカー
• グループ管理（作成・編集・削除・並び替え・色設定）
• ファイル変更の自動検出・更新（操作時）
• キーボードナビゲーション（Home/End対応）
• スクロールインジケーター・グループ統計表示

Requirements

• Go 1.21+
• Claude Code v2.1.16+ (タスク機能を使用する場合)

Installation

go install github.com/jss826/cctasks@latest

または、ソースからビルド:

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

Windows:

winget install GoLang.Go
go build -o cctasks.exe

Usage

./cctasks

Claude Code Task List のセットアップ

Claude Code v2.1.16 以降で Task List 機能を有効にする方法:

1. プロジェクトの .claude/settings.local.json に以下を追加:

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

1. タスクは ~/.claude/tasks/your-project-name/ に保存されます

詳細: https://docs.anthropic.com/en/docs/claude-code/interactive-mode#task-list

Key Bindings

Project Selection

Task List

Task Detail

Task Edit

Group Management

Data Format

タスクは ~/.claude/tasks/<project>/ に個別ファイルとして保存されます:

~/.claude/tasks/<project>/
├── 1.json
├── 2.json
├── 3.json
└── _groups.json

各タスクファイル ({id}.json):

{
  "id": "1",
  "subject": "Task title",
  "description": "Task description",
  "status": "pending",
  "blocks": [],
  "blockedBy": [],
  "owner": "",
  "metadata": {
    "group": "Backend"
  }
}

グループ設定 (_groups.json):

{
  "groups": [
    {
      "name": "Backend",
      "order": 1,
      "color": "#8b5cf6"
    }
  ]
}

License

MIT License - see LICENSE file for details.