cc-mode

Classify your Claude Code sessions by work mode — what kind of work does each session actually do?

npx cc-mode

Zero dependencies. Reads ~/.claude/projects/ directly.

Output

cc-mode — Session Mode Classifier
===================================
Sessions classified: 2,120 (≥5 tool calls)

Session Mode Breakdown
----------------------
⚡ EXECUTE   ████████████████████   873   41.2%  (median 22 calls)
🔀 MIXED     ████████░░░░░░░░░░░░   438   20.7%  (median 30 calls)
📖 READ      ███████░░░░░░░░░░░░░   360   17.0%  (median 16 calls)
🔍 EXPLORE   █████░░░░░░░░░░░░░░░   237   11.2%  (median 22 calls)
💻 CODE      ███░░░░░░░░░░░░░░░░░   146    6.9%  (median 40 calls)
🌐 RESEARCH  █░░░░░░░░░░░░░░░░░░░    45    2.1%  (median 37 calls)
📋 PLAN      █░░░░░░░░░░░░░░░░░░░    21    1.0%  (median 18 calls)

Mode Descriptions
-----------------
⚡ EXECUTE   Bash > 40% — running commands, testing, building
🔀 MIXED     No single tool dominates — multi-step projects
📖 READ      Read > 50% — code review, exploration, learning
🔍 EXPLORE   Glob + Grep > 30% — searching, discovering files
💻 CODE      Edit + Write > 30% — active coding, refactoring
🌐 RESEARCH  WebSearch + WebFetch > 30% — external research
📋 PLAN      ExitPlanMode present — planning before coding

Global Ratios
-------------
Read : Edit = 1.55  (action-oriented)
Read : Bash = 0.34  (Bash runs 2.9x more than Read)

What it tells you

• EXECUTE (41%) dominates — Claude Code is fundamentally an execution machine. Bash runs nearly 3x more than Read.
• CODE sessions are longest (median 40 calls) — iterative edit-verify cycles take time.
• RESEARCH is rare (2%) — Claude Code prefers grep/cat over web search for information gathering.
• PLAN sessions exist (1%) — structured planning before coding, involving ExitPlanMode.
• Read:Bash = 0.34 — for every read, there are nearly 3 Bash commands. Action dominates.

Session archetypes

| Mode | What's happening | |------|-----------------| | ⚡ EXECUTE | Running tests, builds, scripts. Command-heavy session. | | 🔀 MIXED | Complex multi-step work — no clear dominant pattern. | | 📖 READ | Code review, understanding a new codebase, debugging by reading. | | 🔍 EXPLORE | Finding files, searching patterns — discovery phase. | | 💻 CODE | Active feature development or refactoring. | | 🌐 RESEARCH | Web research, documentation reading, API exploration. | | 📋 PLAN | Architecture planning, spec writing with ExitPlanMode. |

Options

npx cc-mode --json    # Raw JSON output

Browser version

yurukusa.github.io/cc-mode — drag and drop your projects folder.

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

Source: yurukusa/cc-mode