agent-dag 1.33.10 → 1.33.12
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
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
#
|
|
3
|
+
# ccdeck
|
|
4
4
|
|
|
5
5
|
**A live canvas for your AI agents.** Watch Claude Code and OpenAI Codex fork subagents, call tools, and finish — all on one calm graph, in real time.
|
|
6
6
|
|
|
7
|
-
[](https://www.npmjs.com/package/ccdeck)
|
|
8
8
|
[](https://www.npmjs.com/package/agents-deck)
|
|
9
9
|
[](LICENSE)
|
|
10
10
|
[](https://nodejs.org)
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
npx ccdeck
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
|
|
18
18
|
|
|
19
19
|
</div>
|
|
20
20
|
|
|
@@ -24,7 +24,7 @@ npx ccdeck
|
|
|
24
24
|
|
|
25
25
|
An agent session is a tree, but a terminal shows it as a scroll. Five subagents working in parallel arrive as one interleaved column of text, and the questions you actually have — *what is running right now, what did that subagent do, which one is stuck, what is this costing* — are the ones the scroll answers worst.
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
ccdeck draws the tree instead. It is read-only, local, and needs no configuration: it registers a hook, listens, and paints.
|
|
28
28
|
|
|
29
29
|
## Quick start
|
|
30
30
|
|
|
@@ -53,7 +53,7 @@ No config file. No account. No telemetry. Nothing leaves your machine except one
|
|
|
53
53
|
|
|
54
54
|
Two capture paths feed one SSE stream, which feeds one canvas.
|
|
55
55
|
|
|
56
|
-
**Claude Code** — on first run,
|
|
56
|
+
**Claude Code** — on first run, ccdeck adds a hook entry to `~/.claude/settings.json` for every relevant event:
|
|
57
57
|
|
|
58
58
|
```
|
|
59
59
|
SessionStart · UserPromptSubmit · PreToolUse · PostToolUse · PostToolUseFailure
|
|
@@ -95,14 +95,14 @@ Nothing is ever installed unless you click, the argument vector is fixed in the
|
|
|
95
95
|
|
|
96
96
|
### Restarting
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
ccdeck runs as a two-process pair: a supervisor that owns nothing but the lifecycle, and the deck itself. When newer code is found, the deck exits with code 75 and the supervisor brings it back **on the port it actually bound**, which is not always the one it asked for. Ctrl+C, stdout and exit codes behave exactly as before — same terminal, same process group.
|
|
99
99
|
|
|
100
100
|
It restarts on its own only after 30 seconds with nothing running, because hook events are fire-and-forget and anything fired during the gap is lost. The toggle in the banner turns that off; the preference is per-browser. Under `--no-persist` a restart is refused outright — with no event log there is nothing to replay, and the canvas would be gone.
|
|
101
101
|
|
|
102
102
|
## Options
|
|
103
103
|
|
|
104
104
|
```
|
|
105
|
-
|
|
105
|
+
ccdeck [options]
|
|
106
106
|
|
|
107
107
|
-p, --port <number> Preferred port (default: 4317; fallback: random 4318–4400)
|
|
108
108
|
--no-open Don't open the browser automatically
|
|
@@ -114,7 +114,7 @@ agents-deck [options]
|
|
|
114
114
|
--no-persist RAM-only mode — don't write or replay the log
|
|
115
115
|
--codex Force Codex capture even if ~/.codex/ is missing
|
|
116
116
|
--no-codex Skip Codex capture (Claude only)
|
|
117
|
-
--uninstall Remove
|
|
117
|
+
--uninstall Remove ccdeck's hooks from settings files
|
|
118
118
|
-h, --help Show this help
|
|
119
119
|
```
|
|
120
120
|
|
|
@@ -135,10 +135,10 @@ Being told to restart after an upgrade is local only — no network involved —
|
|
|
135
135
|
## Uninstall
|
|
136
136
|
|
|
137
137
|
```bash
|
|
138
|
-
npx
|
|
138
|
+
npx ccdeck --uninstall
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
Removes every hook entry
|
|
141
|
+
Removes every hook entry ccdeck injected from `~/.claude/settings.json`, and `~/.codex/hooks.json` if present.
|
|
142
142
|
|
|
143
143
|
## Design
|
|
144
144
|
|
|
@@ -151,18 +151,18 @@ One canvas. No tabs. No kanban.
|
|
|
151
151
|
|
|
152
152
|
## Names
|
|
153
153
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
154
|
+
**ccdeck** is the name — of this repo and of the command. On npm the same build
|
|
155
|
+
is published under three names, and all three ship all three commands, so use
|
|
156
|
+
whichever you can remember.
|
|
157
157
|
|
|
158
158
|
```bash
|
|
159
|
-
npx ccdeck #
|
|
160
|
-
npx agents-deck # the canonical package
|
|
159
|
+
npx ccdeck # this repo's name — the short one
|
|
160
|
+
npx agents-deck # the canonical npm package (in-app updates install this one)
|
|
161
161
|
npx agent-dag # the original name; existing installs and scripts keep working
|
|
162
162
|
```
|
|
163
163
|
|
|
164
|
-
The
|
|
165
|
-
keep working.
|
|
164
|
+
The repository was previously named `agents-deck`; the old URL redirects here,
|
|
165
|
+
so existing clones, links and bookmarks keep working.
|
|
166
166
|
|
|
167
167
|
## Requirements
|
|
168
168
|
|