claude-terminal-prism 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -63
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# claude-terminal-prism
|
|
2
2
|
|
|
3
|
+
```
|
|
4
|
+
██████╗ ██████╗ ██╗███████╗███╗ ███╗
|
|
5
|
+
██╔══██╗██╔══██╗██║██╔════╝████╗ ████║
|
|
6
|
+
██████╔╝██████╔╝██║███████╗██╔████╔██║
|
|
7
|
+
██╔═══╝ ██╔══██╗██║╚════██║██║╚██╔╝██║
|
|
8
|
+
██║ ██║ ██║██║███████║██║ ╚═╝ ██║
|
|
9
|
+
╚═╝ ╚═╝ ╚═╝╚═╝╚══════╝╚═╝ ╚═╝
|
|
10
|
+
```
|
|
11
|
+
|
|
3
12
|
**PRISM** — Agentic visibility layer for Claude. Intercept, record, and debug multi-agent sessions in a real-time dashboard.
|
|
4
13
|
|
|
5
14
|
---
|
|
@@ -12,18 +21,16 @@ npm install -g claude-terminal-prism
|
|
|
12
21
|
|
|
13
22
|
---
|
|
14
23
|
|
|
15
|
-
##
|
|
24
|
+
## Setup
|
|
16
25
|
|
|
17
26
|
```bash
|
|
18
27
|
prism setup
|
|
19
28
|
source ~/.zshrc
|
|
20
29
|
```
|
|
21
30
|
|
|
22
|
-
`prism setup` starts the collector + dashboard daemon, adds a shell alias so every `claude` session is auto-captured, and opens the browser at
|
|
23
|
-
|
|
24
|
-
---
|
|
31
|
+
`prism setup` starts the collector + dashboard daemon, adds a shell alias so every `claude` session is auto-captured, and opens the browser at **http://localhost:4700**.
|
|
25
32
|
|
|
26
|
-
|
|
33
|
+
For more control, run the steps individually:
|
|
27
34
|
|
|
28
35
|
```bash
|
|
29
36
|
prism start # Start collector + dashboard → http://localhost:4700
|
|
@@ -39,70 +46,14 @@ prism uninit # Remove shell integration and hooks
|
|
|
39
46
|
|
|
40
47
|
---
|
|
41
48
|
|
|
42
|
-
## Per-repo install (scoped to a specific project)
|
|
43
|
-
|
|
44
|
-
Install PRISM as a dev dependency in a repo to capture sessions for that project only. A single collector on port `4701` handles **all** your local repos simultaneously — run it once, then add as many repos as you want.
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
# In your project
|
|
48
|
-
npm install --save-dev claude-terminal-prism
|
|
49
|
-
|
|
50
|
-
# Start the shared local collector once (handles all local repos)
|
|
51
|
-
npx prism start --port 4701
|
|
52
|
-
|
|
53
|
-
# Add this repo (run in each repo you want tracked)
|
|
54
|
-
npx prism init --local
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
On each session start, PRISM automatically captures a git snapshot of the repo:
|
|
58
|
-
|
|
59
|
-
- Current branch and commit SHA
|
|
60
|
-
- Staged, unstaged, and untracked files
|
|
61
|
-
- Working-tree diff stat
|
|
62
|
-
- Upstream tracking info (ahead/behind)
|
|
63
|
-
|
|
64
|
-
Sessions in the dashboard are named `parent/repo` (e.g. `work/api`, `personal/website`) so repos with the same folder name stay distinct.
|
|
65
|
-
|
|
66
|
-
### Adding more repos
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
cd ~/work/project-b && npx prism init --local # collector already running — repo is ready
|
|
70
|
-
cd ~/work/project-c && npx prism init --local # same
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
Each `prism init --local` detects whether the collector is already running and adjusts its output accordingly. All repos share one dashboard at `http://localhost:4701`.
|
|
74
|
-
|
|
75
|
-
### Custom port
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
npx prism init --local --port 4702
|
|
79
|
-
npx prism start --port 4702
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
The port is stored in `.claude/settings.json` so `uninit` always removes the exact hooks that were installed.
|
|
83
|
-
|
|
84
|
-
### Remove local hooks
|
|
85
|
-
|
|
86
|
-
```bash
|
|
87
|
-
npx prism uninit --local
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Global and local together
|
|
91
|
-
|
|
92
|
-
Global (`:4700`) and local (`:4701`) run as completely separate processes with separate databases and dashboards — no duplicate events. If you have `prism init` (global) already set up, `prism init --local` in a project will post to `:4701` only.
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
49
|
## Other useful commands
|
|
97
50
|
|
|
98
51
|
```bash
|
|
99
52
|
prism start [--port N] [--no-open] # Start collector + dashboard daemon
|
|
100
53
|
prism stop # Stop the daemon
|
|
101
54
|
prism status # Show running state
|
|
102
|
-
prism init #
|
|
103
|
-
prism
|
|
104
|
-
prism uninit # Remove global shell integration
|
|
105
|
-
prism uninit --local # Remove local project hooks
|
|
55
|
+
prism init # Add shell integration + Claude Code hooks
|
|
56
|
+
prism uninit # Remove shell integration and hooks
|
|
106
57
|
prism tui # Inline terminal dashboard
|
|
107
58
|
prism exec <cmd> # Run a command with full capture
|
|
108
59
|
prism shell # Spawn a captured interactive shell
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-terminal-prism",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "PRISM — Agentic visibility layer for Claude. Intercepts, records, and replays multi-agent sessions.",
|
|
5
5
|
"author": "ashrit-v",
|
|
6
6
|
"homepage": "https://www.npmjs.com/package/claude-terminal-prism",
|