ag-skill v1.0.1 Released
ag-skill v1.0.1 is now live: Release v1.0.1
What's in this release
Local Telemetry — observe, stats, dashboard
v1.0.1 ships four new commands for recording and reviewing skill/agent run
telemetry entirely locally. No external service, no account — everything
lives in .ag-skill/telemetry/runs.jsonl inside your repository.
Because ag-skill runs outside Copilot/Claude/Cursor, token usage is
self-reported by calling one of the observe sub-commands after your
agent finishes.
ag-skill observe
Display the most recent telemetry records as a Rich table.
ag-skill observe
ag-skill observe --tail 50
ag-skill observe -n 0 # show all
ag-skill observe record
Append one record to the telemetry log. Tokens can be supplied as exact counts, estimated from piped stdin, a response file, or inline text (1 token ≈ 4 chars).
# Pipe agent output directly — tokens auto-estimated
my-agent "design DDD aggregates" | ag-skill observe record --skill ddd-aggregate-design --agent ag-architect --model gpt-5 --response-stdin --duration-ms 8200
# Exact token counts from the platform's usage API
ag-skill observe record --skill ddd-aggregate-design --agent ag-architect --model gpt-4o --prompt-tokens 3200 --completion-tokens 1800 --duration-ms 12400
ag-skill observe from-copilot
Auto-read the latest VS Code Copilot Chat transcript — no pasting required. Tokens are estimated (Copilot Chat transcripts do not include usage data).
ag-skill observe from-copilot --skill ddd-aggregate-design --agent ag-architect --model gpt-4o --duration-ms 12400
Omit --skill to preview without recording.
ag-skill observe from-claude
Auto-read the latest Claude Code session and record with exact token counts,
including cache hits (cache_creation_input_tokens and cache_read_input_tokens).
ag-skill observe from-claude --skill ddd-aggregate-design --duration-ms 18500
ag-skill resolves the session from ~/.claude/projects/<encoded-cwd>/. Omit
--skill to preview without recording.
ag-skill observe estimate-tokens
Sanity-check a token estimate for any text before recording.
ag-skill observe estimate-tokens "Design DDD aggregates for the order service..."
# → 11 estimated tokens (47 characters)
ag-skill stats
Print aggregated statistics — totals, per-skill breakdown, and per-model breakdown — as Rich tables.
ag-skill stats
ag-skill dashboard
Generate a self-contained HTML dashboard with summary cards, per-skill and per-model breakdowns, and a full run log (newest first). No internet connection or JavaScript required.
ag-skill dashboard
start .ag-skill/dashboard.html
# Custom output path
ag-skill dashboard --output reports/dash.html
Internal changes
- Added
src/ag_skill/commands/observe.py—observeTyper sub-app withrecord,estimate-tokens,from-copilot, andfrom-claudesub-commands. - Added
src/ag_skill/commands/stats.py—statscommand. - Added
src/ag_skill/commands/dashboard.py—dashboardcommand. - Added
src/ag_skill/core/telemetry.py— low-level JSONL read/write helpers. - Added
src/ag_skill/core/readers.py— transcript parsers for VS Code Copilot Chat (.jsonlunderworkspaceStorage) and Claude Code (~/.claude/projects/). - Added
tests/test_readers.py— unit and CLI integration tests for the new readers andobservesub-commands.
Release artifacts
- Wheel:
ag_skill-1.0.1-py3-none-any.whl - Source distribution:
ag_skill-1.0.1.tar.gz
Both artifacts are attached to the GitHub release.
Changelog links
- Release: v1.0.1
- Full compare: v1.0.0...v1.0.1
- PR: #7
