Skip to content

NetFabric/NetFabric.Numerics / .agents/skills/agent-harness-logs

agent-harness-logs

Verified

Find, 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.

Agent Harness Logs

Harnesses expose three different evidence surfaces. Identify the surface before querying it.

SurfaceTypical contentBest use
Operational/debug logStartup, extensions, network, retries, crashesWhy the harness failed
Session/transcriptPrompts, responses, tools, turn graphWhat happened in one interaction
OpenTelemetryStructured events, metrics, tracesFleet analysis and durable observability

Workflow

  1. Read references/concepts-and-safety.md; never upload or paste an unreviewed log.
  2. Identify the harness and artifact in references/path-matrix.md.
  3. Load the matching reference: VS Code and editors, Copilot CLI and Claude Code, or Codex, Gemini CLI, and OpenCode.
  4. Run python3 scripts/harness_logs.py discover --toon, then inventory the smallest relevant root with --toon.
  5. Query locally using references/query-recipes.md. Use --toon for model-bound output; stream source files and never read a large log wholesale.
  6. Correlate with stable IDs when available: session, turn, prompt, request, tool-call, span, and parent-span IDs.
  7. Redact to a new file, inspect the result manually, then share only the minimum slice needed.
  8. State harness version, OS, artifact type, time window, and whether a path is documented or discovered.

Script

scripts/harness_logs.py uses the Python standard library for queries and the official @toon-format/cli through npx when --toon is requested. It discovers candidate roots, inventories files, streams regex searches, summarizes JSONL fields, runs read-only SQLite queries, and creates best-effort redacted copies. Structured commands retain JSON/JSONL when --toon is omitted. The script never invokes a model.

References

FileLoad when
references/concepts-and-safety.mdHandling sensitive data, large files, or unstable schemas
references/path-matrix.mdLocating artifacts across operating systems
references/vscode-and-editors.mdTroubleshooting Copilot in VS Code or VS Code-family editors
references/copilot-and-claude.mdInspecting Copilot CLI or Claude Code
references/codex-gemini-opencode.mdInspecting Codex, Gemini CLI, or OpenCode
references/query-recipes.mdRunning deterministic, zero-token queries
references/sources.mdVerifying claims or updating version-sensitive details
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 119kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall