prism-analyze

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 (reads JSONL from ~/.claude/projects/ by default):

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.

Agentsview data source

If the user has agentsview installed, PRISM can read from its SQLite database instead of raw JSONL. This gives real API token counts and agentsview's own health scores alongside PRISM's.

prism analyze --source agentsview
prism analyze --source agentsview --agentsview-db /path/to/sessions.db
prism analyze --source agentsview --json

DB path resolution when --agentsview-db is not specified: AGENTSVIEW_DATA_DIR env → AGENT_VIEWER_DATA_DIR env → ~/.agentsview/sessions.db

Use --source agentsview when the user mentions agentsview, asks for real token counts, or wants richer session data. Use the default (no flag) when they just want a quick analysis from raw session files.

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.