NetFabric/NetFabric.Numerics / .agents/skills/agent-harness-logs
agent-harness-logs
VerifiedFind, inspect, query, redact, and troubleshoot logs, transcripts, sessions, and OpenTelemetry data from coding-agent harnesses on Windows, macOS, Linux, and WSL. USE FOR: GitHub Copilot in VS Code; Copilot CLI; Claude Code; OpenAI Codex; Gemini CLI; OpenCode; Cursor, Windsurf, Kiro, or other VS Code-family editors; locating log files; diagnosing tool or model failures; correlating turns, subagents, and tool calls; querying JSONL, plaintext, or SQLite without spending model tokens; preparing sanitized diagnostics. DO NOT USE FOR: application logs unrelated to coding agents; uploading raw logs; treating unstable transcript schemas as public APIs.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
| references/codex-gemini-opencode.md | markdown | 3.2 KB |
| references/concepts-and-safety.md | markdown | 2.5 KB |
| references/copilot-and-claude.md | markdown | 2.8 KB |
| references/path-matrix.md | markdown | 3.2 KB |
| references/query-recipes.md | markdown | 2.9 KB |
| references/sources.md | markdown | 2.0 KB |
| references/vscode-and-editors.md | markdown | 2.4 KB |
| scripts/harness_logs.py | script | 10.3 KB |
| scripts/test_harness_logs.py | script | 4.5 KB |
references/query-recipes.md
View on GitHub# Query Recipes
Run from the skill directory. These commands are local and do not invoke a model.
## Portable Script
```bash
python3 scripts/harness_logs.py discover --toon
python3 scripts/harness_logs.py inventory ~/.copilot/logs --limit 20 --toon
python3 scripts/harness_logs.py search ~/.claude 'error|timeout|429|5[0-9]{2}' --ignore-case --redact --limit 50 --toon
python3 scripts/harness_logs.py jsonl-summary session.jsonl --field type --toon
python3 scripts/harness_logs.py sqlite state.sqlite 'SELECT name FROM sqlite_master WHERE type = "table"' --limit 50 --toon
python3 scripts/harness_logs.py redact input.log sanitized.log
```
Use `--toon` by default when returning results to a model; it uses the official `@toon-format/cli@4.1.1` package through `npx`. Omit the option for JSON/JSONL consumed by existing automation. The first TOON invocation may download the package into the npm cache and therefore requires Node.js, `npx`, and network access; later cached invocations remain local.
`jsonl-summary --field` accepts flattened paths such as `message.role` or `attributes.event.name`. First summarize likely discriminator fields, then search the resulting event names. The SQLite command opens the database read-only and permits only `SELECT`, `PRAGMA`, `WITH`, or `EXPLAIN`.
## Shell Tools
```bash
# Inventory without reading content
find LOG_ROOT -type f -print0 | xargs -0 stat -f '%m %z %N' | sort -nr | head -50 # macOS
find LOG_ROOT -type f -printf '%T@ %s %p\n' | sort -nr | head -50 # Linux
# Stream JSONL event counts and selected failures
jq -r '.type // .event.name // "<missing>"' session.jsonl | sort | uniq -c | sort -nr
jq -c 'select((.level? == "error") or (.success? == false))' session.jsonl | head -100
# Search text with file names and line numbers
rg -n -i --max-count 100 'error|timeout|rate.?limit|429|5[0-9]{2}' LOG_ROOT
# Inspect SQLite schema before querying rows
sqlite3 -readonly state.sqlite '.tables'
sqlite3 -readonly state.sqlite '.schema target_table'
```
On Windows PowerShell:
```powershell
Get-ChildItem LOG_ROOT -File -Recurse |
Sort-Object LastWriteTime -Descending |
Select-Object -First 50 FullName, Length, LastWriteTime
Get-ChildItem LOG_ROOT -File -Recurse |
Select-String -Pattern 'error|timeout|rate.?limit|429|5\d\d' |
Select-Object -First 100 Path, LineNumber, Line
```
## Correlation Order
1. Session or conversation ID
2. Turn, prompt, or interaction ID
3. Request/client-request ID
4. Tool-use/call ID
5. Trace/span and parent-span IDs
6. Timestamp only as a fallback
Use exact IDs before broad text. Clock skew, retries, parallel tools, and subagents make timestamp-only reconstruction unreliable.
## SQLite Safety
Copy a live database only when the harness is stopped or use its supported query/export command. SQLite WAL files may hold recent rows not present in the main file. Never mutate a harness database to investigate it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |