noctrace 1.5.0 → 1.5.1
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/.claude-plugin/plugin.json +2 -2
- package/README.md +20 -20
- package/bin/noctrace.js +4 -0
- package/dist/client/assets/{index-DocLM4cc.js → index-CUBN9piY.js} +1 -1
- package/dist/client/index.html +1 -1
- package/dist/server/shared/parser.js +69 -4
- package/dist/server/shared/security-tips.js +1 -1
- package/dist/server/shared/tips.js +1 -1
- package/hooks/hooks.json +77 -0
- package/package.json +2 -2
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "noctrace",
|
|
3
|
-
"version": "1.5.
|
|
4
|
-
"description": "Chrome DevTools Network-tab-style waterfall visualizer for Claude Code
|
|
3
|
+
"version": "1.5.1",
|
|
4
|
+
"description": "Chrome DevTools Network-tab-style waterfall visualizer for AI coding agent workflows — supports Claude Code, Codex CLI, and GitHub Copilot Chat",
|
|
5
5
|
"author": "Nyktora Group LLC",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"homepage": "https://nyktora.github.io/noctrace/",
|
package/README.md
CHANGED
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
Open-source observability for <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>
|
|
6
|
+
Open-source observability for AI coding agent workflows — supports <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>, <a href="https://github.com/openai/codex">Codex CLI</a>, and <a href="https://github.com/features/copilot">GitHub Copilot Chat</a>.
|
|
7
7
|
Chrome DevTools Network-tab-style waterfall visualizer that monitors tool calls, tracks token usage, and detects context rot — all locally, with zero config.
|
|
8
8
|
<br /><br />
|
|
9
|
-
Noctrace
|
|
9
|
+
Noctrace auto-detects sessions from all three providers and renders them as an interactive waterfall timeline.
|
|
10
10
|
See every tool call, sub-agent spawn, token cost, and context window fill level at a glance.
|
|
11
|
-
Built for developers
|
|
11
|
+
Built for developers who want to understand what their AI agents are actually doing.
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
14
|
<p align="center">
|
|
@@ -25,16 +25,16 @@
|
|
|
25
25
|
|
|
26
26
|
## Why Noctrace?
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
AI agent terminal outputs are opaque. Tool calls show summaries like "Read 3 files" and "Edited 2 files" — no paths, no timing, no concurrency visibility. When sub-agents spawn sub-agents, you're flying blind.
|
|
29
29
|
|
|
30
|
-
Noctrace
|
|
30
|
+
Noctrace auto-detects sessions from Claude Code, Codex CLI, and Copilot Chat and renders them as an interactive waterfall timeline — the same visual paradigm that makes Chrome DevTools' Network tab instantly readable.
|
|
31
31
|
|
|
32
32
|
- **Waterfall timeline** — See tool calls laid out on a time axis, just like Chrome DevTools Network tab
|
|
33
33
|
- **Sub-agent visibility** — Expandable agent rows show nested tool calls from Explore, Plan, and custom agents
|
|
34
34
|
- **Context health scoring** — A-F grade based on context fill, compaction frequency, re-reads, and error acceleration
|
|
35
|
-
- **Token cost tracking** — Per-row USD estimates using
|
|
35
|
+
- **Token cost tracking** — Per-row USD estimates using per-model pricing (Opus, Sonnet, Haiku for Claude; GPT-4o for Codex)
|
|
36
36
|
- **Efficiency and security tips** — Automatic detection of wasteful patterns and security anti-patterns
|
|
37
|
-
- **Zero config** — Just run `npx noctrace` and it
|
|
37
|
+
- **Zero config** — Just run `npx noctrace` and it auto-detects sessions from all supported providers
|
|
38
38
|
|
|
39
39
|
## Install
|
|
40
40
|
|
|
@@ -42,7 +42,7 @@ Noctrace reads Claude Code's session logs from `~/.claude/projects/` and renders
|
|
|
42
42
|
npx noctrace
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
That's it. No config required. Noctrace starts a local server, opens your browser, and
|
|
45
|
+
That's it. No config required. Noctrace starts a local server, opens your browser, and auto-detects sessions from Claude Code, Codex CLI, and Copilot Chat immediately.
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
48
|
# Or install globally
|
|
@@ -58,6 +58,18 @@ claude plugin install nyktora/noctrace
|
|
|
58
58
|
|
|
59
59
|
Requires Node.js 20+. Optional `--install-hooks` flag enables real-time hook events from Claude Code.
|
|
60
60
|
|
|
61
|
+
## Supported providers
|
|
62
|
+
|
|
63
|
+
Noctrace reads sessions from multiple AI coding tools automatically — no configuration required for any of them:
|
|
64
|
+
|
|
65
|
+
| Provider | Source | Badge |
|
|
66
|
+
|---|---|---|
|
|
67
|
+
| **Claude Code** | `~/.claude/projects/` JSONL session logs | (default) |
|
|
68
|
+
| **OpenAI Codex CLI** | `~/.codex/sessions/` rollout JSONL files | orange `codex` |
|
|
69
|
+
| **GitHub Copilot Chat** | VS Code workspaceStorage JSON session files | blue `copilot` |
|
|
70
|
+
|
|
71
|
+
All three show up in the same session picker. Context health scoring and token cost are available for Claude Code and Codex sessions. Copilot sessions show the waterfall timeline and tool call detail panel; token tracking is not available because Copilot Chat does not expose token counts.
|
|
72
|
+
|
|
61
73
|
## Features
|
|
62
74
|
|
|
63
75
|
- **Waterfall Timeline Visualization** — horizontal bars on a shared time axis showing tool call concurrency and duration, just like Chrome DevTools Network tab
|
|
@@ -173,18 +185,6 @@ npm run dev # starts server + Vite dev server
|
|
|
173
185
|
- **Tests**: Vitest 4
|
|
174
186
|
- **Language**: TypeScript 5.9 (strict mode)
|
|
175
187
|
|
|
176
|
-
## Supported providers
|
|
177
|
-
|
|
178
|
-
Noctrace reads sessions from multiple AI coding tools automatically — no configuration required for any of them:
|
|
179
|
-
|
|
180
|
-
| Provider | Source | Badge |
|
|
181
|
-
|---|---|---|
|
|
182
|
-
| **Claude Code** | `~/.claude/projects/` JSONL session logs | (default) |
|
|
183
|
-
| **OpenAI Codex CLI** | `~/.codex/sessions/` rollout JSONL files | orange `codex` |
|
|
184
|
-
| **GitHub Copilot Chat** | VS Code workspaceStorage JSON session files | blue `copilot` |
|
|
185
|
-
|
|
186
|
-
All three show up in the same session picker. Context health scoring and token cost are available for Claude Code and Codex sessions. Copilot sessions show the waterfall timeline and tool call detail panel; token tracking is not available because Copilot Chat does not expose token counts.
|
|
187
|
-
|
|
188
188
|
## Compatibility
|
|
189
189
|
|
|
190
190
|
Noctrace works with all Claude Code versions that write JSONL session logs to `~/.claude/projects/`. This includes:
|
package/bin/noctrace.js
CHANGED
|
@@ -17,12 +17,16 @@ const HOOK_EVENT_NAMES = [
|
|
|
17
17
|
'SubagentStart',
|
|
18
18
|
'SubagentStop',
|
|
19
19
|
'Stop',
|
|
20
|
+
'StopFailure',
|
|
20
21
|
'PreCompact',
|
|
21
22
|
'PostCompact',
|
|
22
23
|
'SessionStart',
|
|
23
24
|
'SessionEnd',
|
|
24
25
|
'PermissionRequest',
|
|
25
26
|
'PermissionDenied',
|
|
27
|
+
'TaskCreated',
|
|
28
|
+
'TaskCompleted',
|
|
29
|
+
'TeammateIdle',
|
|
26
30
|
'WorktreeCreate',
|
|
27
31
|
'WorktreeRemove',
|
|
28
32
|
];
|