@lanegrid/agtrace 0.1.5 → 0.1.7

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 (4) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +29 -7
  3. package/npm-shrinkwrap.json +2 -2
  4. package/package.json +20 -10
package/CHANGELOG.md CHANGED
@@ -2,6 +2,53 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [0.1.7] - 2025-12-28
6
+
7
+ ### Features
8
+
9
+ - Add demo mode to showcase TUI without requiring local logs ([a7f3261](https://github.com/lanegrid/agtrace/commit/a7f3261))
10
+
11
+ ### Bug Fixes
12
+
13
+ - Change turn percentage display from cumulative to delta (incremental) ([65eeaa5](https://github.com/lanegrid/agtrace/commit/65eeaa5))
14
+ - Preserve all events in demo to prevent turn count reduction ([1bbe397](https://github.com/lanegrid/agtrace/commit/1bbe397))
15
+ - Link demo notifications to progress bar percentage instead of event index ([07f0577](https://github.com/lanegrid/agtrace/commit/07f0577))
16
+ - Unify progress bar calculation to include both input and output tokens ([49e0b5b](https://github.com/lanegrid/agtrace/commit/49e0b5b))
17
+ - Add context window limit enforcement to demo token generation ([f6771c5](https://github.com/lanegrid/agtrace/commit/f6771c5))
18
+ - Update demo model name and prevent context window overflow ([c708a9c](https://github.com/lanegrid/agtrace/commit/c708a9c))
19
+ - Assemble session from events to display turn data in demo mode ([7f77b87](https://github.com/lanegrid/agtrace/commit/7f77b87))
20
+ - Correct provider default log paths in help text ([0d6f5b8](https://github.com/lanegrid/agtrace/commit/0d6f5b8))
21
+
22
+ ### Refactoring
23
+
24
+ - Unify --source option to --provider across CLI ([657cd40](https://github.com/lanegrid/agtrace/commit/657cd40))
25
+ - Rename source to provider in internal API ([b7ab5a4](https://github.com/lanegrid/agtrace/commit/b7ab5a4))
26
+ - Centralize CLI command hints to prevent duplication and typos ([6188a34](https://github.com/lanegrid/agtrace/commit/6188a34))
27
+ - Add scenario builder pattern and expand demo to 7 turns with 100+ events ([7917ffb](https://github.com/lanegrid/agtrace/commit/7917ffb))
28
+ - Unify token usage logic by using engine's extract_state_updates in demo ([a79f5b9](https://github.com/lanegrid/agtrace/commit/a79f5b9))
29
+ - Remove hardcoded context limit in demo, use configurable constant ([9277085](https://github.com/lanegrid/agtrace/commit/9277085))
30
+
31
+ ### Documentation
32
+
33
+ - Add VHS demo gif and agtrace demo command documentation ([ea15513](https://github.com/lanegrid/agtrace/commit/ea15513))
34
+ - Regenerate demo.gif with cargo-installed agtrace v0.1.6 ([ef0b1c7](https://github.com/lanegrid/agtrace/commit/ef0b1c7))
35
+ - Reduce demo.gif size for better readability (1200x700) ([d328478](https://github.com/lanegrid/agtrace/commit/d328478))
36
+ - Organize demo generation scripts into scripts/demo directory ([acd1d46](https://github.com/lanegrid/agtrace/commit/acd1d46))
37
+ - Increase demo.gif font size for better readability (FontSize 18) ([508d1c1](https://github.com/lanegrid/agtrace/commit/508d1c1))
38
+ - Improve CLI help text and command descriptions for better UX ([0ae8b91](https://github.com/lanegrid/agtrace/commit/0ae8b91))
39
+ - Remove unnecessary documents ([98bb313](https://github.com/lanegrid/agtrace/commit/98bb313))
40
+ - Add centered logo to README header ([0327721](https://github.com/lanegrid/agtrace/commit/0327721))
41
+ - Add crates.io badge and cargo install instructions ([2908ebb](https://github.com/lanegrid/agtrace/commit/2908ebb))
42
+
43
+ ## [0.1.6] - 2025-12-27
44
+
45
+ ### Infrastructure
46
+
47
+ - Rename CLI package from `agtrace-cli` to `agtrace` for better discoverability on crates.io
48
+ - Add crates.io publishing automation to GitHub Actions release workflow
49
+ - Mark internal crates with `agtrace-internal` keyword to prevent accidental usage
50
+ - Add package metadata (categories, keywords, readme) for crates.io optimization
51
+
5
52
  ## [0.1.5] - 2025-12-27
6
53
 
7
54
  ### Bug Fixes
package/README.md CHANGED
@@ -1,10 +1,12 @@
1
- # agtrace
1
+ <div align="center">
2
+ <img src="docs/images/agtrace-icon.png" width="96" alt="agtrace logo">
3
+ <h1>agtrace</h1>
4
+ <p><strong>The Vital Monitor for AI Coding Agents.</strong></p>
5
+ <p>Real-time telemetry, context window tracking, and session forensics for Claude Code, Codex, and Gemini. <strong>Built in Rust for zero-overhead monitoring.</strong></p>
2
6
 
3
- **The Vital Monitor for AI Coding Agents.**
4
-
5
- Real-time telemetry, context window tracking, and session forensics for Claude Code, Codex, and Gemini. **Built in Rust for zero-overhead monitoring.**
6
-
7
- [![npm version](https://img.shields.io/npm/v/@lanegrid/agtrace.svg?style=flat)](https://www.npmjs.com/package/@lanegrid/agtrace)
7
+ [![npm version](https://img.shields.io/npm/v/@lanegrid/agtrace.svg?style=flat)](https://www.npmjs.com/package/@lanegrid/agtrace)
8
+ [![crates.io](https://img.shields.io/crates/v/agtrace.svg)](https://crates.io/crates/agtrace)
9
+ </div>
8
10
 
9
11
  ---
10
12
 
@@ -20,6 +22,10 @@ You are effectively flying a plane without a fuel gauge.
20
22
 
21
23
  **agtrace** is a local-only telemetry tool that acts as a "Vital Check" for your AI agents. by normalizing logs from various providers, it visualizes the internal state of your agent in real-time.
22
24
 
25
+ ![agtrace watch demo](demo.gif)
26
+
27
+ *Live demo of `agtrace watch` - Real-time AI session monitoring*
28
+
23
29
  ![agtrace watch TUI dashboard](docs/images/watch-screenshot-claude.png)
24
30
 
25
31
  *The dashboard showing Context Window usage, current turn, and token costs*
@@ -59,7 +65,7 @@ We recommend installing `agtrace` globally for the best performance and quick ac
59
65
  npm install -g @lanegrid/agtrace
60
66
  ```
61
67
 
62
- ### ⚡ Or use via npx
68
+ ### via npx (no installation)
63
69
 
64
70
  If you prefer not to install it globally, you can run commands using `npx`.
65
71
  *Note: In the examples below, replace `agtrace` with `npx @lanegrid/agtrace`.*
@@ -68,11 +74,27 @@ If you prefer not to install it globally, you can run commands using `npx`.
68
74
  npx @lanegrid/agtrace@latest init
69
75
  ```
70
76
 
77
+ ### via Cargo (Rust)
78
+
79
+ ```bash
80
+ cargo install agtrace
81
+ ```
82
+
71
83
 
72
84
  ---
73
85
 
74
86
  ## 🚀 Quick Start
75
87
 
88
+ ### 0. Try the Demo (Optional)
89
+
90
+ See `agtrace watch` in action without setting up logs:
91
+
92
+ ```bash
93
+ agtrace demo
94
+ ```
95
+
96
+ This simulates a live AI session to demonstrate the TUI dashboard. Use `--speed fast` for a quicker preview.
97
+
76
98
  ### 1. Initialize in Your Project
77
99
 
78
100
  Navigate to your project directory and run:
package/npm-shrinkwrap.json CHANGED
@@ -23,7 +23,7 @@
23
23
  "hasInstallScript": true,
24
24
  "license": "MIT OR Apache-2.0",
25
25
  "name": "@lanegrid/agtrace",
26
- "version": "0.1.5"
26
+ "version": "0.1.7"
27
27
  },
28
28
  "node_modules/@isaacs/balanced-match": {
29
29
  "engines": {
@@ -515,5 +515,5 @@
515
515
  }
516
516
  },
517
517
  "requires": true,
518
- "version": "0.1.5"
518
+ "version": "0.1.7"
519
519
  }
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.5",
2
+ "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.7",
3
3
  "bin": {
4
4
  "agtrace": "run-agtrace.js"
5
5
  },
@@ -10,7 +10,7 @@
10
10
  "detect-libc": "^2.1.2",
11
11
  "rimraf": "^6.1.2"
12
12
  },
13
- "description": "Terminal UI and command-line interface for exploring AI agent execution traces",
13
+ "description": "A CLI tool to visualize and analyze AI agent execution traces (Claude, Gemini, etc.) in a unified timeline.",
14
14
  "devDependencies": {
15
15
  "prettier": "^3.7.4"
16
16
  },
@@ -23,6 +23,16 @@
23
23
  "series": 35
24
24
  },
25
25
  "homepage": "https://github.com/lanegrid/agtrace",
26
+ "keywords": [
27
+ "command-line-utilities",
28
+ "development-tools::debugging",
29
+ "visualization",
30
+ "ai",
31
+ "agent",
32
+ "llm",
33
+ "trace",
34
+ "tui"
35
+ ],
26
36
  "license": "MIT OR Apache-2.0",
27
37
  "name": "@lanegrid/agtrace",
28
38
  "preferUnplugged": true,
@@ -34,56 +44,56 @@
34
44
  },
35
45
  "supportedPlatforms": {
36
46
  "aarch64-apple-darwin": {
37
- "artifactName": "agtrace-cli-aarch64-apple-darwin.tar.xz",
47
+ "artifactName": "agtrace-aarch64-apple-darwin.tar.xz",
38
48
  "bins": {
39
49
  "agtrace": "agtrace"
40
50
  },
41
51
  "zipExt": ".tar.xz"
42
52
  },
43
53
  "aarch64-pc-windows-msvc": {
44
- "artifactName": "agtrace-cli-x86_64-pc-windows-msvc.zip",
54
+ "artifactName": "agtrace-x86_64-pc-windows-msvc.zip",
45
55
  "bins": {
46
56
  "agtrace": "agtrace.exe"
47
57
  },
48
58
  "zipExt": ".zip"
49
59
  },
50
60
  "aarch64-unknown-linux-gnu": {
51
- "artifactName": "agtrace-cli-aarch64-unknown-linux-gnu.tar.xz",
61
+ "artifactName": "agtrace-aarch64-unknown-linux-gnu.tar.xz",
52
62
  "bins": {
53
63
  "agtrace": "agtrace"
54
64
  },
55
65
  "zipExt": ".tar.xz"
56
66
  },
57
67
  "x86_64-apple-darwin": {
58
- "artifactName": "agtrace-cli-x86_64-apple-darwin.tar.xz",
68
+ "artifactName": "agtrace-x86_64-apple-darwin.tar.xz",
59
69
  "bins": {
60
70
  "agtrace": "agtrace"
61
71
  },
62
72
  "zipExt": ".tar.xz"
63
73
  },
64
74
  "x86_64-pc-windows-gnu": {
65
- "artifactName": "agtrace-cli-x86_64-pc-windows-msvc.zip",
75
+ "artifactName": "agtrace-x86_64-pc-windows-msvc.zip",
66
76
  "bins": {
67
77
  "agtrace": "agtrace.exe"
68
78
  },
69
79
  "zipExt": ".zip"
70
80
  },
71
81
  "x86_64-pc-windows-msvc": {
72
- "artifactName": "agtrace-cli-x86_64-pc-windows-msvc.zip",
82
+ "artifactName": "agtrace-x86_64-pc-windows-msvc.zip",
73
83
  "bins": {
74
84
  "agtrace": "agtrace.exe"
75
85
  },
76
86
  "zipExt": ".zip"
77
87
  },
78
88
  "x86_64-unknown-linux-gnu": {
79
- "artifactName": "agtrace-cli-x86_64-unknown-linux-gnu.tar.xz",
89
+ "artifactName": "agtrace-x86_64-unknown-linux-gnu.tar.xz",
80
90
  "bins": {
81
91
  "agtrace": "agtrace"
82
92
  },
83
93
  "zipExt": ".tar.xz"
84
94
  }
85
95
  },
86
- "version": "0.1.5",
96
+ "version": "0.1.7",
87
97
  "volta": {
88
98
  "node": "18.14.1",
89
99
  "npm": "9.5.0"