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/vscode-and-editors.md
View on GitHub# VS Code and Editors
## GitHub Copilot in VS Code
Start with supported UI surfaces because VS Code profile, remote-host, web, and Insiders layouts differ.
1. Open **View: Toggle Output** and select **GitHub Copilot**, **GitHub Copilot Chat**, or the relevant extension-host channel.
2. Run **Developer: Open Logs Folder** for the current VS Code instance.
3. Run **Developer: Show Logs...** and inspect **Extension Host**, **Window**, and **Shared Process** when startup or activation failed.
4. Reproduce once, note the timestamp, then search only the newest matching log directory.
5. For extension failures, use **Help: Report Issue** and choose the extension when appropriate.
Stable VS Code desktop discovery candidates are listed in [path-matrix.md](path-matrix.md). Remote SSH, WSL, dev containers, Codespaces, browser clients, profiles, and portable mode can move or split logs.
## Direct Copilot Chat Debug Sessions
Current VS Code Copilot Chat builds can produce session-scoped JSONL diagnostics under workspace/profile storage. This is an internal troubleshooting surface, not a stable public schema. A session may include:
| File or event | Typical role |
| --- | --- |
| `main.jsonl` | Main event stream |
| `models.json` | Model metadata |
| `system_prompt_*.json` | Captured system prompts; highly sensitive |
| `tools_*.json` | Tool definitions or details |
| Child JSONL files | Subagent event streams |
| `discovery`, `tool_call`, `llm_request`, `agent_response`, `user_message`, `subagent` | Common event categories in current builds |
| `spanId`, `parentSpanId` | Parent-child correlation when present |
Always inspect the actual keys first. Build-specific event names and files can change.
## Cursor, Windsurf, Kiro, and Other Editors
Use a product-supported sequence:
1. Open its Output/Logs panel and choose the agent or extension channel.
2. Use its **Open Logs Folder**, diagnostics bundle, issue reporter, or support command.
3. Separate editor renderer/main-process logs from extension-host and remote-agent logs.
4. Check whether the agent is a bundled service, a VS Code extension, or a separate CLI; each owns different files.
5. If documentation does not publish a path, report the path as discovered for that product version and OS.
Do not present a VS Code-derived directory as authoritative for another editor. Proprietary products can relocate, rename, rotate, or sanitize logs without a public compatibility promise.
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 |