Skip to content

yurukusa/cc-bash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors