Grok Build Live Trace Viewer
Watch a live Grok Build session in VS Code's bottom panel (same strip as
Terminal, Problems, Output). The panel is wide enough for the turn
outline and the event stream side by side.
The panel is a webview over the local Traceview server (parser + UI). The
extension starts that server when it can, then follows the live session
for this workspace (~/.grok/active_sessions.json), not a stale
pending.json id.
Install (coworkers)
Repo: CodeNoEvil/grok-traceview
git clone git@github.com:CodeNoEvil/grok-traceview.git ~/src/traceview
cd ~/src/traceview
Either download the latest grok-traceview-*.vsix from Actions → package
→ artifacts on main, or build it:
Install uv and Node 20+.
First-time server deps + VSIX:
uv sync
cd frontend && npm install && cd ..
./scripts/package-vsix.sh
Install the VSIX:
code --install-extension vscode/grok-traceview-0.2.3.vsix
Or Extensions → … → Install from VSIX…. Then Developer: Reload Window.
Point grokTraceview.installPath at the clone if you want the live checkout
instead of the copy bundled in the VSIX.
Settings (Grok Build Live Trace Viewer):
| Setting |
Default |
Meaning |
grokTraceview.liveScroll |
true |
Open a new turn when the session grows one. Click an older turn to pin; click latest (or this setting) to follow again. |
grokTraceview.autoStart |
true |
Start uvicorn if :8016 is down. |
grokTraceview.installPath |
(empty) |
Path to the checkout (pyproject.toml). Falls back to the bundled copy in the VSIX, then ~/src/traceview. |
grokTraceview.apiPort |
8016 |
Local API port. |
Use
- Bottom panel tab: Grok Build Live Trace Viewer
- Command Palette: Grok Build Live Trace Viewer: Open
- From Grok:
/trace (writes ~/.cache/traceview/pending.json and opens
vscode://codenoevil.traceview/open)
- Header toggle live scroll matches the setting
If the panel is empty after the first install, Reload Window once so the
extension activates.
