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/codex-gemini-opencode.md
View on GitHub# Codex, Gemini CLI, and OpenCode
## OpenAI Codex CLI
| Surface | Location or control |
| --- | --- |
| Home | `$CODEX_HOME`, default `~/.codex` |
| Rollout sessions | `$CODEX_HOME/sessions/YYYY/MM/DD/*.jsonl` |
| Archived sessions | `$CODEX_HOME/archived_sessions/` in current versions |
| Prompt history | `$CODEX_HOME/history.jsonl` when persistence is enabled |
| Plaintext log | Configure `log_dir`; output is `<log_dir>/codex-tui.log` |
| Rust verbosity | `RUST_LOG`, for example `RUST_LOG=codex_core=debug` |
| Login diagnostics | `codex-login.log` in affected/current login flows |
| TUI recording | `CODEX_TUI_RECORD_SESSION` and `CODEX_TUI_SESSION_LOG_PATH` in builds that expose them |
Do not assume `codex-tui.log` always exists. Current behavior requires an explicit `log_dir` for plaintext file logging. Newer versions also use a bounded SQLite log store and provide a `codex-state-logs` query client; discover the database/schema for the installed version and query read-only.
Codex supports OTEL logs, traces, and metrics through its configuration. Prefer the documented OTEL schema for durable automation and JSONL rollouts for session reconstruction. Treat rollout schemas as version-sensitive.
## Gemini CLI
| Surface | Location or control |
| --- | --- |
| Debug UI | `gemini --debug` or `-d`; F12 opens the debug console |
| Debug file | Set `GEMINI_DEBUG_LOG_FILE` in versions that expose it |
| Sessions | `~/.gemini/tmp/<project_hash>/chats/session-*.jsonl` by default |
| Session inventory | `gemini --list-sessions` |
| Local telemetry | Set `telemetry.target: "local"` and `telemetry.outfile`, or environment equivalents |
| Retention | `general.sessionRetention` settings; current default maximum age is 30 days |
`GEMINI_CLI_HOME` changes the user-level root. Local file telemetry is the recommended debugging target. Environment overrides include `GEMINI_TELEMETRY_ENABLED`, `GEMINI_TELEMETRY_TRACES_ENABLED`, `GEMINI_TELEMETRY_TARGET`, `GEMINI_TELEMETRY_OTLP_ENDPOINT`, `GEMINI_TELEMETRY_OTLP_PROTOCOL`, `GEMINI_TELEMETRY_OUTFILE`, and `GEMINI_TELEMETRY_LOG_PROMPTS`.
Telemetry can include `session.id`, `installation.id`, approval mode, and authenticated email. Current docs list `logPrompts` as enabled by default when telemetry itself is enabled, so explicitly disable it when content is unnecessary.
## OpenCode
| Surface | Location or control |
| --- | --- |
| Logs | `~/.local/share/opencode/log/`; current docs retain the newest 10 |
| Verbosity | `opencode --log-level DEBUG` |
| Terminal output | `opencode --print-logs` |
| Session list | `opencode session list --format json` |
| Session export | `opencode export --sanitize <sessionID>` |
| Database | `opencode db path`; query through `opencode db` or read-only SQLite |
| Data | `~/.local/share/opencode/`, including project session/message storage |
On Windows, official docs use `%USERPROFILE%\.local\share\opencode`. Source builds may honor XDG variables. Prefer `opencode db path` and CLI exports over hard-coded storage internals because OpenCode has changed storage implementations.
OpenCode Desktop adds UI/main-process logs and state separate from the CLI sidecar. Use its built-in debug-log export, then inspect the archive before sharing.
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 |