prism

---

The problem

Your Claude Code sessions are silently wasting tokens and you don't know why.

Running PRISM against real session data from a single machine found:

• A project with 6738% CLAUDE.md re-read cost in one session: a 237-line file being re-read on every tool call
• A project where CLAUDE.md re-reads consumed 480% of total session tokens: more tokens on instructions than on actual work
• 4 migration file edits in a project that had a rule saying never to touch them. The rule existed, Claude ignored it
• 5 consecutive tool failures in a single session with no diagnosis

None of this was visible before PRISM. The token counter just said you hit your limit.

---

What PRISM does

PRISM reads Claude Code's session files from ~/.claude/projects/ (the same files Claude Code writes automatically) and tells you three things:

1. Why your tokens are disappearing: CLAUDE.md re-read costs, retry loops, compaction losses, sidechain waste
2. Whether your CLAUDE.md rules are actually being followed, or silently ignored mid-session
3. Exactly what to change: concrete diff recommendations, not generic advice

You keep using Claude Code exactly as normal. PRISM is the tool you run after.

---

Quick start

# Install
pip install prism-cc

# Analyze all your Claude Code projects
prism analyze

# Get specific CLAUDE.md fix recommendations
prism advise

# Open the full interactive dashboard
prism

# Open the HTML dashboard in your browser
prism dashboard

# Watch a session live as it runs
prism watch

# Or install as a Claude Code plugin
/plugin marketplace add jakeefr/prism
/plugin install prism@prism
/reload-plugins

Then just ask Claude: "analyze my Claude Code sessions"

Note: PRISM needs to be installed via pip to work: pip install prism-cc If pip isn't installed, Claude Code will detect this and walk you through the installation automatically before running the analysis.

---

What you'll see

 Project                   Overall   Token Eff.  Tool Health  Ctx Hygiene  MD Adherence  Continuity
 myapp                      C+        D           B+           D            C             A
 ai-assistant               C         F           A            B            B+            A-
 data-pipeline              C+        C+          D            B            C+            B
 web-scraper                C+        D+          B            B+           B             A
 cli-tool                   B+        B+          A-           B+           A             A

Followed by the advisor:

╭──────────────────────────────────────────────────────────╮
│  PRISM ADVISOR - recommendations for myapp               │
╰──────────────────────────────────────────────────────────╯

  ✦ TRIM  (High impact - silent token drain every session)
    Remove lines 120–148: personality/tone instructions
    Claude Code's system prompt already handles this.
    These 29 lines cost tokens on every single tool call.

  ✦ RESTRUCTURE  (Reduce root-level re-read cost)
    Move 3 rules to subdirectory CLAUDE.md files:
    - "Use functional components only in React"
    - "Import from @/components, never relative paths"
    - "Run bun run typecheck after TypeScript changes"
    These only matter in src/, and loading them globally wastes
    tokens in every session that doesn't touch that directory.

📊 HTML Dashboard Preview

The HTML dashboard. Open in any browser with prism dashboard

Expand any project to see dimension scores, top issues, and CLAUDE.md recommendations

---