Skip to content

Commit d9f2981

Browse files
committed
docs: update skills and plugin.json for 0.3.0 agentsview integration
Add --source agentsview examples and DB path resolution docs to all three skill files. Bump plugin.json version from 0.2.0 to 0.3.0.
1 parent 6610f3b commit d9f2981

4 files changed

Lines changed: 39 additions & 3 deletions

File tree

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "prism",
33
"description": "Session intelligence for Claude Code — find why your sessions fail and fix them",
4-
"version": "0.2.0",
4+
"version": "0.3.0",
55
"author": { "name": "jakeefr" },
66
"license": "MIT",
77
"repository": "https://github.com/jakeefr/prism"

skills/prism-advise/SKILL.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,15 @@ For a different project:
4141
prism advise --project <path>
4242
```
4343

44+
From an agentsview database (real API token counts, richer data):
45+
```bash
46+
prism advise --source agentsview
47+
prism advise --source agentsview --agentsview-db /path/to/sessions.db
48+
```
49+
50+
DB path resolution: `AGENTSVIEW_DATA_DIR``AGENT_VIEWER_DATA_DIR``~/.agentsview/sessions.db`.
51+
Note: `--project` cannot be used with `--source agentsview`.
52+
4453
## Interpreting the output
4554

4655
PRISM prints recommendations with four action types:

skills/prism-analyze/SKILL.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Once confirmed installed, proceed with the analysis.
3232

3333
## Usage
3434

35-
Run the analysis:
35+
Run the analysis (reads JSONL from ~/.claude/projects/ by default):
3636
```bash
3737
prism analyze
3838
```
@@ -67,6 +67,25 @@ This prints each project name, session count, and last-active timestamp.
6767
Use it when the user asks what projects PRISM has data for, or to confirm
6868
that sessions are being recorded.
6969

70+
## Agentsview data source
71+
72+
If the user has [agentsview](https://github.com/wesm/agentsview) installed,
73+
PRISM can read from its SQLite database instead of raw JSONL. This gives
74+
real API token counts and agentsview's own health scores alongside PRISM's.
75+
76+
```bash
77+
prism analyze --source agentsview
78+
prism analyze --source agentsview --agentsview-db /path/to/sessions.db
79+
prism analyze --source agentsview --json
80+
```
81+
82+
DB path resolution when `--agentsview-db` is not specified:
83+
`AGENTSVIEW_DATA_DIR` env → `AGENT_VIEWER_DATA_DIR` env → `~/.agentsview/sessions.db`
84+
85+
Use `--source agentsview` when the user mentions agentsview, asks for real
86+
token counts, or wants richer session data. Use the default (no flag) when
87+
they just want a quick analysis from raw session files.
88+
7089
## What PRISM shows
7190
- Health scores (A-F) across 5 dimensions per project
7291
- Token efficiency: CLAUDE.md re-read costs, compaction frequency

skills/prism-dashboard/SKILL.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,14 @@ Generate the dashboard without opening a browser:
3636
prism dashboard --no-open
3737
```
3838

39+
From an agentsview database (real API token counts, health score cross-reference):
40+
```bash
41+
prism dashboard --source agentsview --no-open
42+
prism dashboard --source agentsview --agentsview-db /path/to/sessions.db --no-open
43+
```
44+
45+
DB path resolution: `AGENTSVIEW_DATA_DIR``AGENT_VIEWER_DATA_DIR``~/.agentsview/sessions.db`.
46+
3947
The dashboard is written to `~/.claude/prism/dashboard.html`. Tell the
4048
user the exact path so they can open it in their browser.
4149

@@ -58,4 +66,4 @@ On most systems this is:
5866
- The dashboard regenerates every time `prism analyze` or
5967
`prism dashboard` runs. Reload the browser page after a new analysis.
6068
- No data leaves the machine. The dashboard reads from local session
61-
files only.
69+
files (or the agentsview SQLite DB with `--source agentsview`) only.

0 commit comments

Comments
 (0)