agents-deck 1.18.0 → 1.19.0

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.
Files changed (8) hide show
  1. package/README.md +71 -33
  2. package/dist/web/assets/index-Bs89BdrR.js +62 -0
  3. package/dist/web/assets/{index-DGqLVo1U.css → index-CVsr6RfQ.css} +1 -1
  4. package/dist/web/index.html +2 -2
  5. package/package.json +1 -1
  6. package/src/server/index.mjs +9 -0
  7. package/src/server/quota.mjs +133 -0
  8. package/dist/web/assets/index-uANyTzBq.js +0 -62
package/README.md CHANGED
@@ -1,52 +1,66 @@
1
1
  # agents-deck
2
2
 
3
- Live deck of Claude Code **and OpenAI Codex** agents. Watch parallel subagents fork, call tools, and return — all on one calm canvas.
3
+ [![npm](https://img.shields.io/npm/v/agents-deck?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/agents-deck)
4
+ [![npm downloads](https://img.shields.io/npm/dm/agents-deck?color=blue)](https://www.npmjs.com/package/agents-deck)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
6
+ [![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen?logo=node.js&logoColor=white)](https://nodejs.org)
4
7
 
5
- > Formerly **agent-dag**. The old name still works — `agents-deck` and `agent-dag` are published as the same package, and the `agent-dag` command remains a built-in alias.
8
+ Live canvas for **Claude Code** and **OpenAI Codex** agents. Watch parallel subagents fork, call tools, and finish — all on one calm graph.
6
9
 
7
- ## Run
10
+ ![agents-deck — live agent DAG](image_2026-06-16_08-58-42.png)
11
+
12
+ ## Quick start
8
13
 
9
14
  ```bash
10
15
  npx agents-deck
11
16
  ```
12
17
 
13
- Opens http://127.0.0.1:4317 (or a random port in 4318–4400 if 4317 is taken). Start a Claude Code **or Codex** session in any directory and watch the graph fill in. Both providers render side by side on the same canvas; the model chip on each node tells them apart (e.g. `Opus 4.8`, `GPT-5.5`).
18
+ Opens **http://127.0.0.1:4317** and auto-registers the Claude Code hook. Start any Claude Code or Codex session and the graph fills in live.
14
19
 
15
- ## Options
20
+ No config. No install step. Ctrl+C to stop.
16
21
 
17
- ```
18
- -p, --port <number> Preferred port (default: 4317; falls back to random 4318–4400)
19
- --no-open Don't open the browser automatically
20
- --workspace <path> Only capture sessions whose cwd is inside <path>
21
- --scope Restrict to the current working directory
22
- --all Capture sessions from all workspaces (machine-wide; default)
23
- --codex Force-enable Codex capture even if ~/.codex/ is missing
24
- --no-codex Skip Codex capture (Claude only)
25
- --history <path> Override events log file (default: ~/.claude/agent-dag/events.jsonl)
26
- --no-persist RAM-only mode, no log file
27
- --uninstall Remove agents-deck hooks from ~/.claude/settings.json
28
- -h, --help Show help
29
- ```
22
+ ## Features
30
23
 
31
- ## Design
32
-
33
- - One canvas. No tabs. No kanban.
34
- - Node = agent (root session, subagent).
35
- - Edge = parent → child (spawn) or agent → tool (call).
36
- - In-flight edges animate; settled edges fade.
37
- - Click a node for details.
24
+ - **Live DAG** — nodes are agents, edges are spawns and tool calls; in-flight edges animate, settled edges fade
25
+ - **Dual provider** — Claude Code via hooks, Codex via log-tail; both appear on the same canvas; the model chip (`Opus 4.8`, `GPT-5.5`) tells them apart
26
+ - **Click-to-inspect** — click any node for prompt, tool calls, token usage, and timing
27
+ - **Persistent replay** — events survive restarts; the log at `~/.claude/agent-dag/events.jsonl` replays the last session on open
28
+ - **Workspace filter** — `--scope` limits capture to the current directory; `--workspace <path>` for any subtree
29
+ - **Zero trust step for Codex** — no hook install, no `/hooks` trust prompt; the server tails `~/.codex/sessions/` directly
38
30
 
39
31
  ## How it works
40
32
 
41
- Two providers, two capture paths — both stream to the same server, which pushes events to the browser over SSE.
33
+ Two capture paths feed one SSE stream → one browser canvas.
42
34
 
43
- **Claude Code** — `agents-deck` registers a hook script in `~/.claude/settings.json` for these events:
35
+ **Claude Code** — on first run `agents-deck` injects a hook entry into `~/.claude/settings.json` for every relevant event:
44
36
 
45
- `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `SubagentStart`, `SubagentStop`, `Stop`, `SessionEnd`, `Notification`.
37
+ ```
38
+ SessionStart · UserPromptSubmit · PreToolUse · PostToolUse · PostToolUseFailure
39
+ SubagentStart · SubagentStop · Stop · SessionEnd · Notification
40
+ ```
41
+
42
+ Each hook fires the bundled `hook.js`, which POSTs the event JSON to the running server.
43
+
44
+ **OpenAI Codex** — Codex CLI hooks don't fire reliably on Windows (the sandbox refuses to spawn them). Instead, the server tails Codex's rollout files at `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` and reconstructs an equivalent event stream — session start, prompts, tool calls, token usage, model. No hook install, no trust step needed. Set `CODEX_HOME` to override the default path.
46
45
 
47
- The hook forwards the event JSON to the running server.
46
+ ## Options
48
47
 
49
- **OpenAI Codex** — Codex CLI hooks don't fire reliably on Windows (the sandbox refuses to spawn the hook command), so instead the server tails Codex's session rollout files at `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` and reconstructs the same event stream (session start, prompts, tool calls, token usage, model). No hook install and no `/hooks` trust step is needed — just run a Codex session and it shows up. Honors `CODEX_HOME` if set.
48
+ ```
49
+ agents-deck [options]
50
+
51
+ -p, --port <number> Preferred port (default: 4317; fallback: random 4318–4400)
52
+ --no-open Don't open the browser automatically
53
+ --workspace <path> Only capture sessions whose cwd is inside <path>
54
+ --scope Restrict to the current working directory
55
+ --all Capture every session on this machine (default)
56
+ --history <path> Override the events log file
57
+ (default: ~/.claude/agent-dag/events.jsonl)
58
+ --no-persist RAM-only mode — don't write or replay the log
59
+ --codex Force Codex capture even if ~/.codex/ is missing
60
+ --no-codex Skip Codex capture (Claude only)
61
+ --uninstall Remove agents-deck hooks from settings files
62
+ -h, --help Show this help
63
+ ```
50
64
 
51
65
  ## Uninstall
52
66
 
@@ -54,8 +68,32 @@ The hook forwards the event JSON to the running server.
54
68
  npx agents-deck --uninstall
55
69
  ```
56
70
 
57
- Removes all hooks from `~/.claude/settings.json`.
71
+ Removes all hook entries injected by agents-deck from `~/.claude/settings.json` (and `~/.codex/hooks.json` if present).
72
+
73
+ ## Legacy name
74
+
75
+ Formerly **agent-dag**. Both names publish the same package and the `agent-dag` command is a built-in alias — existing installs and scripts keep working.
76
+
77
+ ```bash
78
+ # both work identically
79
+ npx agents-deck
80
+ npx agent-dag
81
+ ```
82
+
83
+ ## Design
84
+
85
+ One canvas. No tabs. No kanban.
86
+
87
+ - Node = agent (root session or subagent)
88
+ - Edge = parent → child (spawn) or agent → tool (call)
89
+ - In-flight = animated; settled = dimmed
90
+ - Click a node for full details
91
+
92
+ ## Requirements
93
+
94
+ - Node.js ≥ 18
95
+ - Claude Code CLI or OpenAI Codex CLI (or both)
58
96
 
59
- ## Status
97
+ ## License
60
98
 
61
- Pre-alpha. Names, ports, and event shapes may change.
99
+ MIT © [Bargan Constantin](https://github.com/BarganConstantin)