Skip to content

Commit eda8409

Browse files
jakeefrclaude
andcommitted
feat: v0.2.0 — HTML dashboard, plugin install, attention curve scorer, docs
- prism/dashboard.py: self-contained HTML dashboard at ~/.claude/prism/dashboard.html; auto-regenerated by prism analyze; prism dashboard command with --serve / --no-open - prism/advisor.py: _recommend_attention_curve() flags critical CLAUDE.md rules buried in the LLM attention dead zone (middle 55% of file); RESTRUCTURE recommendation - prism/cli.py: dashboard_cmd + auto-regenerate dashboard after analyze - plugin.json + skills/prism-analyze/SKILL.md: Claude Code plugin (skills only, no hooks) - assets/splash.svg: redesigned — larger prism, 6-colour refracted rays with glow layers - assets/dashboard-preview.png + dashboard-detail.png: README screenshots from mock data - docs/: how-it-works.md, claude-md-guide.md, commands.md, faq.md - tests/test_dashboard.py: 15 new tests (96 total, all passing) - Bump version 0.1.2 -> 0.2.0 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 611b8d7 commit eda8409

20 files changed

Lines changed: 2485 additions & 7 deletions

README.md

Lines changed: 79 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,19 @@
1+
<p align="center">
2+
<img src="assets/splash.svg" alt="PRISM" width="800">
3+
</p>
4+
5+
<p align="center">
6+
<img src="assets/dashboard-preview.png" alt="The HTML dashboard — open in any browser with prism dashboard" width="900">
7+
<br>
8+
<em>The HTML dashboard — open in any browser with <code>prism dashboard</code></em>
9+
</p>
10+
11+
<p align="center">
12+
<img src="assets/dashboard-detail.png" alt="Expand any project to see dimension scores, top issues, and CLAUDE.md recommendations" width="900">
13+
<br>
14+
<em>Expand any project to see dimension scores, top issues, and CLAUDE.md recommendations</em>
15+
</p>
16+
117
# Prism
218

319
**Session intelligence for Claude Code. Find out why your sessions are burning tokens, and fix them.**
@@ -6,13 +22,12 @@
622
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
723
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
824
[![Tests](https://img.shields.io/github/actions/workflow/status/jakeefr/prism/tests.yml?label=tests)](https://github.com/jakeefr/prism/actions)
25+
[![PyPI downloads](https://img.shields.io/pypi/dm/prism-cc?label=installs)](https://pypi.org/project/prism-cc/)
26+
[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-orange.svg)](https://github.com/jakeefr/prism)
27+
[![Zero dependencies](https://img.shields.io/badge/external%20deps-4-brightgreen.svg)](pyproject.toml)
928

1029
![PRISM demo](https://raw.githubusercontent.com/jakeefr/prism/main/demo.gif)
1130

12-
```bash
13-
pip install prism-cc
14-
```
15-
1631
---
1732

1833
## The problem
@@ -57,6 +72,9 @@ prism advise
5772
# Open the full interactive dashboard
5873
prism
5974

75+
# Open the HTML dashboard in your browser
76+
prism dashboard
77+
6078
# Watch a session live as it runs
6179
prism watch
6280
```
@@ -125,6 +143,55 @@ PRISM never touches Claude Code. It never modifies your sessions. It reads the J
125143

126144
---
127145

146+
## Trust & Safety
147+
148+
<details>
149+
<summary><b>Does PRISM send any data anywhere?</b></summary>
150+
151+
No. PRISM never makes network calls. All analysis runs locally against files
152+
already on your machine. No telemetry, no analytics, no external servers.
153+
</details>
154+
155+
<details>
156+
<summary><b>Can PRISM hurt my Claude Code sessions?</b></summary>
157+
158+
No. PRISM is read-only — it never modifies session files. It reads
159+
`~/.claude/projects/` but never writes to it. Your sessions are completely
160+
untouched.
161+
</details>
162+
163+
<details>
164+
<summary><b>Does PRISM modify my CLAUDE.md without asking?</b></summary>
165+
166+
Only if you explicitly run `prism advise --apply` and confirm the prompt.
167+
`prism advise` (without --apply) only prints recommendations — it never
168+
touches any file.
169+
</details>
170+
171+
<details>
172+
<summary><b>What data does PRISM read?</b></summary>
173+
174+
Only the JSONL session files Claude Code writes to `~/.claude/projects/`
175+
and your CLAUDE.md files. It reads nothing else. No API keys, no environment
176+
variables, no network traffic.
177+
</details>
178+
179+
<details>
180+
<summary><b>Does it work with Claude Code Max / Pro / Team?</b></summary>
181+
182+
Yes — PRISM reads local session files which are written by all Claude Code
183+
subscription tiers. The analysis works identically regardless of your plan.
184+
</details>
185+
186+
<details>
187+
<summary><b>What are PRISM's dependencies?</b></summary>
188+
189+
Four packages: textual, rich, typer, watchdog. All well-maintained,
190+
widely-used Python libraries. No C extensions, no compiled binaries.
191+
</details>
192+
193+
---
194+
128195
## The CLAUDE.md re-read problem
129196

130197
Every tool call Claude Code makes re-reads your CLAUDE.md from the top of the context. A 200-line CLAUDE.md × 50 tool calls = 10,000 tokens spent on instructions, per session. If your CLAUDE.md has grown to include personality instructions, full documentation copies, or rules that only apply to one subdirectory — you're paying for all of it every time.
@@ -144,6 +211,9 @@ prism analyze --project ~/myproject # One project only
144211
prism analyze --json # JSON output for scripting
145212
prism advise # CLAUDE.md recommendations
146213
prism advise --apply # Write recommendations (with confirmation)
214+
prism dashboard # Generate HTML dashboard and open in browser
215+
prism dashboard --serve # Serve on localhost:19821
216+
prism dashboard --no-open # Generate only, don't open browser
147217
prism replay <session-id> # Scrub through a session timeline
148218
prism watch # Live dashboard for the running session
149219
prism projects # List all projects with session counts
@@ -154,12 +224,16 @@ prism projects # List all projects with session counts
154224
## Install
155225

156226
```bash
157-
# pip
227+
# pip (standalone CLI)
158228
pip install prism-cc
159229

160230
# pipx (recommended — isolated install)
161231
pipx install prism-cc
162232

233+
# Claude Code plugin
234+
/plugin marketplace add jakeefr/prism
235+
/plugin install prism
236+
163237
# from source
164238
git clone https://github.com/jakeefr/prism
165239
cd prism

0 commit comments

Comments
 (0)