@lanegrid/agtrace 0.1.4 → 0.1.6

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 +25 -0
  2. package/README.md +22 -8
  3. package/npm-shrinkwrap.json +2 -2
  4. package/package.json +20 -10
package/CHANGELOG.md CHANGED
@@ -2,6 +2,31 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
+ ## [0.1.6] - 2025-12-27
6
+
7
+ ### Infrastructure
8
+
9
+ - Rename CLI package from `agtrace-cli` to `agtrace` for better discoverability on crates.io
10
+ - Add crates.io publishing automation to GitHub Actions release workflow
11
+ - Mark internal crates with `agtrace-internal` keyword to prevent accidental usage
12
+ - Add package metadata (categories, keywords, readme) for crates.io optimization
13
+
14
+ ## [0.1.5] - 2025-12-27
15
+
16
+ ### Bug Fixes
17
+
18
+ - Correct init command hints to suggest 'watch' and 'session list' instead of non-existent 'list' ([bf1ce4f](https://github.com/lanegrid/agtrace/commit/bf1ce4f))
19
+
20
+
21
+ ### Documentation
22
+
23
+ - Reorder Quick Start to emphasize 'watch' workflow as primary use case ([bd9e03c](https://github.com/lanegrid/agtrace/commit/bd9e03c))
24
+
25
+ - Clarify Quick Start workflow with explicit agent launch steps and no-integration requirement ([09d7e29](https://github.com/lanegrid/agtrace/commit/09d7e29))
26
+
27
+ - Update screenshot to use Claude-specific dashboard image ([e504ee4](https://github.com/lanegrid/agtrace/commit/e504ee4))
28
+
29
+
5
30
  ## [0.1.4] - 2025-12-27
6
31
 
7
32
  ### Bug Fixes
package/README.md CHANGED
@@ -20,7 +20,7 @@ You are effectively flying a plane without a fuel gauge.
20
20
 
21
21
  **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
22
 
23
- ![agtrace watch TUI dashboard](docs/images/watch-screenshot.png)
23
+ ![agtrace watch TUI dashboard](docs/images/watch-screenshot-claude.png)
24
24
 
25
25
  *The dashboard showing Context Window usage, current turn, and token costs*
26
26
 
@@ -73,26 +73,40 @@ npx @lanegrid/agtrace@latest init
73
73
 
74
74
  ## 🚀 Quick Start
75
75
 
76
- ### 1. Initialize
76
+ ### 1. Initialize in Your Project
77
77
 
78
- Run this in your project root to detect installed providers (Claude, etc.) and index existing sessions.
78
+ Navigate to your project directory and run:
79
79
 
80
80
  ```bash
81
+ cd /path/to/your/project
81
82
  agtrace init
82
83
  ```
83
84
 
84
- ### 2. Watch Mode (The "Vital Check")
85
+ ### 2. Start Your AI Coding Agent
85
86
 
86
- Open a new terminal pane and run the watch command. This will launch the TUI dashboard.
87
+ In one terminal, launch your usual AI coding agent:
88
+
89
+ ```bash
90
+ # Example: Claude Code
91
+ claude
92
+
93
+ # Or Codex, Gemini, etc.
94
+ ```
95
+
96
+ ### 3. Watch in Another Terminal
97
+
98
+ Open a separate terminal pane in the same project directory and run:
87
99
 
88
100
  ```bash
89
101
  agtrace watch
90
102
  ```
91
103
 
104
+ That's it. No integration required—agtrace automatically detects and monitors your agent session.
105
+
92
106
  * **Visualizes:** Context Window usage, Cost, Turns, and Last Activity.
93
- * **Auto-Switch:** When you start a `claude` or `codex` session in another pane, agtrace automatically latches onto the new log file.
107
+ * **Auto-Switch:** When you start a new session, agtrace automatically latches onto it.
94
108
 
95
- ### 3. Analyze Past Sessions
109
+ ### 4. Analyze Past Sessions
96
110
 
97
111
  List recent sessions across all providers or inspect a specific one.
98
112
 
@@ -105,7 +119,7 @@ agtrace session show <session_id>
105
119
 
106
120
  ```
107
121
 
108
- ### 4. Advanced: The "Lab"
122
+ ### 5. Advanced: The "Lab"
109
123
 
110
124
  Debug agent interactions or search for specific patterns (e.g., "When did the agent try to write to `package.json`?").
111
125
 
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.4"
26
+ "version": "0.1.6"
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.4"
518
+ "version": "0.1.6"
519
519
  }
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.4",
2
+ "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.6",
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.4",
96
+ "version": "0.1.6",
87
97
  "volta": {
88
98
  "node": "18.14.1",
89
99
  "npm": "9.5.0"