cc-bash

See which shell commands Claude Code runs most — and spot the ones that should use a dedicated tool instead.

npx cc-bash

  cc-bash — Shell Command Breakdown
  ════════════════════════════════════════

  ▸ Overview
    Total Bash calls:        54,341
    "Use a dedicated tool":  17,105  (31.5%)

  ▸ Top shell commands
    cat                 ████████████████   5,175  → use Read
    ls                  ███████████████░   4,735  → use Glob
    grep                ██████████████░░   4,498  → use Grep
    sleep               ████████████░░░░   3,822
    python3             ████████████░░░░   3,723
    git                 ███████░░░░░░░░░   2,246
    find                █████░░░░░░░░░░░   1,493  → use Glob

  ▸ Commands with dedicated tool alternatives
    cat         5,175 calls  → Read tool
    ls          4,735 calls  → Glob tool
    grep        4,498 calls  → Grep tool
    find        1,493 calls  → Glob tool
    head          411 calls  → Read tool
    sed           395 calls  → Edit tool
    tail          382 calls  → Read tool

  ~31% of Bash calls could use dedicated tools

Browser version

Drag and drop your ~/.claude folder at: https://yurukusa.github.io/cc-bash/

Nothing is uploaded. All analysis runs locally in your browser.

Options

npx cc-bash           # interactive output
npx cc-bash --json    # JSON output for scripting

What it shows

• Top shell commands — ranked by frequency, with anti-pattern detection
• Dedicated tool alternatives — which Bash calls should use Read/Glob/Grep/Edit instead
• Anti-pattern count — percentage of Bash calls that could be improved

Why it matters

Claude Code has dedicated tools for common operations:

• Read — better than cat, head, tail
• Glob — better than ls, find
• Grep — better than grep, rg
• Edit — better than sed, awk

Dedicated tools give users better visibility into what Claude is doing and avoid sandbox restrictions.

Part of cc-toolkit

One of 104 free tools for Claude Code users.