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.
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)
- 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/catover 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.
| 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. |
npx cc-mode --json # Raw JSON output
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