@lanegrid/agtrace 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.5] - 2025-12-27
+
+### Bug Fixes
+
+- Correct init command hints to suggest 'watch' and 'session list' instead of non-existent 'list' ([bf1ce4f](https://github.com/lanegrid/agtrace/commit/bf1ce4f))
+
+
+### Documentation
+
+- Reorder Quick Start to emphasize 'watch' workflow as primary use case ([bd9e03c](https://github.com/lanegrid/agtrace/commit/bd9e03c))
+
+- Clarify Quick Start workflow with explicit agent launch steps and no-integration requirement ([09d7e29](https://github.com/lanegrid/agtrace/commit/09d7e29))
+
+- Update screenshot to use Claude-specific dashboard image ([e504ee4](https://github.com/lanegrid/agtrace/commit/e504ee4))
+
+
 ## [0.1.4] - 2025-12-27
 
 ### Bug Fixes

package/README.md

@@ -20,7 +20,7 @@ You are effectively flying a plane without a fuel gauge.
 
 **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.
 
-![agtrace watch TUI dashboard](docs/images/watch-screenshot.png)
+![agtrace watch TUI dashboard](docs/images/watch-screenshot-claude.png)
 
 *The dashboard showing Context Window usage, current turn, and token costs*
 
@@ -73,26 +73,40 @@ npx @lanegrid/agtrace@latest init
 
 ## 🚀 Quick Start
 
-### 1. Initialize
+### 1. Initialize in Your Project
 
-Run this in your project root to detect installed providers (Claude, etc.) and index existing sessions.
+Navigate to your project directory and run:
 
 ```bash
+cd /path/to/your/project
 agtrace init
 ```
 
-### 2. Watch Mode (The "Vital Check")
+### 2. Start Your AI Coding Agent
 
-Open a new terminal pane and run the watch command. This will launch the TUI dashboard.
+In one terminal, launch your usual AI coding agent:
+
+```bash
+# Example: Claude Code
+claude
+
+# Or Codex, Gemini, etc.
+```
+
+### 3. Watch in Another Terminal
+
+Open a separate terminal pane in the same project directory and run:
 
 ```bash
 agtrace watch
 ```
 
+That's it. No integration required—agtrace automatically detects and monitors your agent session.
+
 * **Visualizes:** Context Window usage, Cost, Turns, and Last Activity.
-* **Auto-Switch:** When you start a `claude` or `codex` session in another pane, agtrace automatically latches onto the new log file.
+* **Auto-Switch:** When you start a new session, agtrace automatically latches onto it.
 
-### 3. Analyze Past Sessions
+### 4. Analyze Past Sessions
 
 List recent sessions across all providers or inspect a specific one.
 
@@ -105,7 +119,7 @@ agtrace session show <session_id>
 
 ```
 
-### 4. Advanced: The "Lab"
+### 5. Advanced: The "Lab"
 
 Debug agent interactions or search for specific patterns (e.g., "When did the agent try to write to `package.json`?").
 

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT OR Apache-2.0",
       "name": "@lanegrid/agtrace",
-      "version": "0.1.4"
+      "version": "0.1.5"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -515,5 +515,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.4"
+  "version": "0.1.5"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.4",
+  "artifactDownloadUrl": "https://github.com/lanegrid/agtrace/releases/download/v0.1.5",
   "bin": {
     "agtrace": "run-agtrace.js"
   },
@@ -83,7 +83,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.1.4",
+  "version": "0.1.5",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"