You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Live session overlay for [agent-trace](https://github.com/Siddhant-K-code/agent-trace). Shows what your agent is doing without leaving the editor.
3
+
Live session overlay for [agent-trace](https://github.com/Siddhant-K-code/agent-trace). See what your agent is doing without leaving the editor.
4
+
5
+
Works in VS Code, Cursor, and any Open VSX-compatible editor.
4
6
5
7
## Features
6
8
7
-
**Status bar** — cost, tool call count, and active tool name, updated on every event. Click to open the event stream panel.
9
+
**Status bar** — live cost, tool call count, and active tool name, updated on every event. Click to open the event stream panel.
8
10
9
11
```
10
12
$(pulse) agent $0.0042 47 calls [Read]
11
13
```
12
14
13
-
**Gutter annotations** — files the agent has read or modified get a colored left border and inline label:
15
+
**Gutter annotations** — files the agent has read or modified get a colored left border and inline label.
14
16
15
17
```
16
18
src/auth/middleware.ts ← agent read 3×, modified 1× this session
17
19
src/db/schema.ts ← agent read 1× this session
18
20
```
19
21
20
-
**Event stream panel** — live feed of every tool call, file op, LLM request, and error in the Explorer sidebar. Same information as `agent-strace watch` but in the editor.
22
+
**Event stream panel** — live feed of every tool call, file op, LLM request, and error in the Explorer sidebar.
23
+
24
+
**Session browser** — Explorer sidebar tree listing all sessions with timestamp, duration, tool calls, and error count. Click any session to open a summary.
21
25
22
-
**Pause button** — stop the agent mid-session without killing it. Writes a signal file that `agent-strace watch` picks up and sends SIGSTOP to the agent process. Resume resumes it.
26
+
**Post-mortem viewer** — when `agent-strace watch` kills a session (timeout, budget, or rule), the viewer opens automatically. Shows kill reason, cost at death, last tool call, and a copyable recovery context for pasting into a new session.
27
+
28
+
**Pause button** — stop the agent mid-session without killing it. Sends SIGSTOP to the agent process via `agent-strace watch`. Resume resumes it.
23
29
24
30
## Requirements
25
31
26
-
-[agent-trace](https://pypi.org/project/agent-strace/) installed (`pip install agent-strace` or `uv tool install agent-strace`)
32
+
-[agent-strace](https://pypi.org/project/agent-strace/) installed: `pip install agent-strace` or `uv tool install agent-strace`
27
33
- A session started via `agent-strace setup` (Claude Code hooks) or `agent-strace record` (MCP proxy)
28
34
29
35
The extension activates automatically when a `.agent-traces/` directory exists in the workspace root.
30
36
31
-
## Usage
37
+
## Setup
38
+
39
+
```bash
40
+
# 1. Install agent-strace
41
+
pip install agent-strace
42
+
43
+
# 2. Add hooks to Claude Code (one-time)
44
+
agent-strace setup
45
+
46
+
# 3. Open your project in VS Code / Cursor
47
+
# Extension activates automatically when .agent-traces/ exists
48
+
49
+
# 4. Start Claude Code — status bar appears immediately
50
+
```
32
51
33
-
1. Install agent-trace and set up hooks:
34
-
```bash
35
-
agent-strace setup # adds hooks to .claude/settings.json
36
-
```
37
-
2. Open your project in VS Code / Cursor.
38
-
3. Start Claude Code — the status bar item appears as soon as the session starts.
39
-
4. Open the **Agent Trace** panel in the Explorer sidebar for the full event stream.
52
+
## Commands
40
53
41
-
The **Pause** button in the panel (or `agent-trace: Pause Agent` command) sends SIGSTOP to the agent. This requires `agent-strace watch` to be running in a terminal alongside the session.
54
+
All commands are available from the Command Palette (`Cmd/Ctrl+Shift+P`):
55
+
56
+
| Command | Description |
57
+
|---|---|
58
+
|`agent-trace: Open Live Stream`| Open the event stream panel |
59
+
|`agent-trace: Open Event Stream`| Open the main agent-strace panel |
60
+
|`agent-trace: View Post-Mortem`| View the watchdog post-mortem for the latest killed session |
61
+
|`agent-trace: Refresh Session Browser`| Reload the session list |
62
+
|`agent-trace: Reveal Session in Browser`| Jump to a session by ID |
63
+
|`agent-trace: Pause Agent`| Send SIGSTOP to the agent (requires `watch` running) |
64
+
|`agent-trace: Resume Agent`| Send SIGCONT to resume a paused agent |
65
+
|`agent-trace: Clear File Decorations`| Remove all gutter annotations from the editor |
66
+
67
+
## Watchdog integration
68
+
69
+
Run `agent-strace watch` alongside your session to enable the pause button and post-mortem viewer:
When the watchdog kills a session, the post-mortem viewer opens automatically. The "Copy recovery context" button copies a summary you can paste into a new session to resume where the agent left off.
42
77
43
78
## Configuration
44
79
45
80
| Setting | Default | Description |
46
81
|---|---|---|
47
82
|`agentTrace.traceDir`|`.agent-traces`| Path to trace store, relative to workspace root |
83
+
|`agentTrace.collectorEndpoint`|`""`| Remote collector URL (leave empty for local mode) |
84
+
|`agentTrace.watchdogPollIntervalSeconds`|`5`| How often (seconds) the status bar polls for updates |
85
+
|`agentTrace.sessionBrowserRefreshInterval`|`5`| How often (seconds) the session browser refreshes |
48
86
|`agentTrace.showGutterAnnotations`|`true`| Gutter icons on agent-touched files |
49
87
|`agentTrace.showInlineText`|`true`| Inline read/write counts at top of file |
50
88
@@ -53,3 +91,5 @@ The **Pause** button in the panel (or `agent-trace: Pause Agent` command) sends
53
91
The extension watches `.agent-traces/.active-session` for the current session ID, then tails `events.ndjson` for new events using `fs.watch`. No polling when idle. No network calls. No new processes.
54
92
55
93
Pause works by writing `.agent-traces/.pause-request` — `agent-strace watch` checks for this file on every poll cycle and sends SIGSTOP / SIGCONT to the agent PID.
94
+
95
+
The post-mortem viewer reads `watchdog-postmortem.json` from the session directory, written by `agent-strace watch` on kill.
0 commit comments