cc-fail

See which tools fail most in your Claude Code sessions.

npx cc-fail

What it shows

• Overall failure rate — what % of tool calls return errors
• Per-tool failure rates — Bash, WebFetch, Read, Edit, Write...
• Error categories — bash-exit, token-limit, permission, timeout, network
• Per-project failure rates — which project has the most errors
• Worst session — the single session with the highest failure rate

Example output

cc-fail — Tool Failure Analysis
════════════════════════════════════════

▸ Overview
  Total tool calls:  144,851
  Failed:               7,060 (4.9%)
  Succeeded:          137,791 (95.1%)

▸ Failure rate by tool
  WebFetch              24.7%  376/1521
  Bash                   6.2%  3377/54178
  Read                   2.1%  84/4001

▸ Error types
  bash-exit            ████████████████  2499
  parallel-error       ██████░░░░░░░░░░  1005
  token-limit          ██░░░░░░░░░░░░░░   429
  permission           █░░░░░░░░░░░░░░░   198

JSON output

npx cc-fail --json

Part of cc-toolkit

60 free tools for Claude Code users. → yurukusa.github.io/cc-toolkit