Prism prism-analyze

Analyze Claude Code session health using PRISM. Use when asked to check token usage, audit CLAUDE.md, understand why sessions are failing, or list projects.

install
source · Clone the upstream repo
git clone https://github.com/jakeefr/prism
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jakeefr/prism "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/prism-analyze" ~/.claude/skills/jakeefr-prism-prism-analyze && rm -rf "$T"
manifest: skills/prism-analyze/SKILL.md
source content

prism-analyze

Analyze Claude Code session health using PRISM.

When to use

When the user asks to analyze their Claude Code sessions, check token usage, audit their CLAUDE.md, understand why sessions are failing, list their projects, or see what PRISM can see.

Before running

First check if PRISM is installed:

prism --version

If the command is not found, install it first:

pip install prism-cc

Then verify it installed correctly:

prism --version

Once confirmed installed, proceed with the analysis.

Usage

Run the analysis:

prism analyze

If prism is not installed:

pip install prism-cc
prism analyze

For a specific project:

prism analyze --project <path>

For JSON output (useful for scripting):

prism analyze --json

For CLAUDE.md recommendations:

prism advise

List all projects PRISM can see:

prism projects

This prints each project name, session count, and last-active timestamp. Use it when the user asks what projects PRISM has data for, or to confirm that sessions are being recorded.

What PRISM shows

  • Health scores (A-F) across 5 dimensions per project
  • Token efficiency: CLAUDE.md re-read costs, compaction frequency
  • Tool health: retry loops, edit-revert cycles, consecutive failures
  • Context hygiene: compaction loss events, mid-task boundaries
  • CLAUDE.md adherence: whether your rules are actually being followed
  • Session continuity: resume success rate, truncated sessions

Output

PRISM prints a health report table and top issues per project. Run

prism
(no args) to open the interactive TUI dashboard. Run
prism dashboard
to open the HTML dashboard in your browser.