cc-todo

How does Claude Code manage tasks? 12,067 tasks tracked across 1,786 todo lists. 59.2% completion rate. One session tracked 2,841 task snapshots.

TodoWrite analysis — completion rate, task counts, session patterns.

npx cc-todo

No install. No dependencies.

What it shows

• Completion rate — % of tasks marked done
• Status breakdown — Completed / In progress / Pending
• Session distribution — 1 write vs 2-5 vs 6-20 vs 21+ per session
• Averages — tasks per write, max tasks in one call
• Insights — heavy planner detection, open task count

Output

  cc-todo — Task Management
  ════════════════════════════════════════

  ▸ Overview
    TodoWrite calls:    1,786
    Total tasks:        12,067
    Completion rate:    59.2%
    Avg tasks/write:    6.8
    Max tasks in write: 50
    Max session total:  2,841
    Sessions with todo: 60

  ▸ Task status breakdown
    Completed    ✓  ████████████████  59.2%  (7,146)
    In progress  ◎  ███░░░░░░░░░░░░░  12.7%  (1,537)
    Pending      ○  ████████░░░░░░░░  28.0%  (3,384)

  ▸ TodoWrite calls per session
    1 write      ██░░░░░░░░░░░░   6.7%
    2-5 writes   ██████████░░░░  30.0%
    6-20 writes  ██████████████  41.7%
    21+ writes   ███████░░░░░░░  21.7%

  ▸ Insights
    59.2% of 12,067 tasks were marked done.
    40.8% (4,921 tasks) remain open or in-flight.
    Longest session tracked 2,841 task snapshots — heavy planner.

Options

npx cc-todo          # terminal output
npx cc-todo --json   # JSON output for scripting

JSON output

{
  "version": "1.0.0",
  "totalTodoWrites": 1786,
  "totalTasks": 12067,
  "completionRate": 59.2,
  "byStatus": { "completed": 7146, "inProgress": 1537, "pending": 3384 },
  "avgTasksPerWrite": 6.8,
  "maxTasksInSingleWrite": 50,
  "maxTasksInSession": 2841,
  "sessionsWithTodo": 60
}

Browser version

Try it without installing: yurukusa.github.io/cc-todo

Drag-drop your ~/.claude/projects/ folder (or any subfolder) to analyze.

How it works

Reads ~/.claude/projects/**/*.jsonl session transcripts and extracts every TodoWrite tool call. Counts tasks by status (completed, in_progress, pending) and aggregates per-session and per-write patterns. Zero external dependencies.

Part of cc-toolkit — 69 tools for understanding your Claude Code sessions.