Analyze Agent Host debug log bundles to diagnose Copilot session failures.
npx skills add https://github.com/Tyrizx/Tyrizx --skill agent-host-logs-tyrizx
Please help me install this Agent Skill. Skill: agent-host-logs Source: https://github.com/Tyrizx/Tyrizx/tree/main/.github/skills/agent-host-logs Command: npx skills add https://github.com/Tyrizx/Tyrizx --skill agent-host-logs-tyrizx
ah-logs export (events.jsonl, usage.jsonl, customizations.json, ahp/*.jsonl, agenthost logs, copilot-logs, vscode-logs) and what each one records. - Safe Extraction: Ships a hardened Python extractor that validates zip structure, blocks path traversal, symlinks, encrypted entries, and oversized archives before unpacking to a temp folder. - Guided Triage Workflow: Maps symptoms (turn behavior, token usage, client ordering, host failures, SDK issues, UI problems) to the right starting file and lists correlation fields like session ID, turnId, and AHP serverSeq. - Use Case: Given an ah-logs.zip from a user reporting a stuck Copilot turn, extract it, open events.jsonl for the turn, then follow the same turnId into the AHP and agenthost logs to find the failed response. ## Quick Start Extract the attached ah-logs zip with the bundled script and analyze events.jsonl to find why the Copilot turn failed.High-intent search queries and answers about installing and using this skill.
Export the bundle with the 'Developer: Export Agent Host Debug Logs' command, extract the zip with the bundled extract.py script, then start from the file closest to the symptom such as events.jsonl for turn behavior or ahp/*.jsonl for client-server ordering.
Run python3 scripts/extract.py with the archive path. The script validates the central directory, rejects path traversal, symlinks, encrypted entries, and oversized archives, then extracts to a temporary folder and prints its path.
events.jsonl contains persisted Copilot SDK events for a session such as turns, tools, and permissions over a long period. AHP JSONL files capture connection-scoped wire traffic between client and server with c2s/s2c direction and wire timestamps.
These files exist only when agent-host debug logging was enabled during the session. Export collection is best-effort, so missing files are normal and do not indicate a corrupted bundle.
Search by the known time or ID in the file closest to the symptom, then follow correlation fields like session ID, turnId, interactionId, JSON-RPC request id, or AHP serverSeq into the adjacent layer such as agenthost.log or copilot-logs.
microsoftAnalyze Agent Host debug log bundles for VS Code sessions.
JimmyChen-NXPReproduce GitHub issue bugs via Playwright and capture screenshots and console logs.
Pieverse-EngManages MOTRAC-style WebSocket sessions with JSON-RPC for AI agents and humans.
anthrilIdentify dead code across multi-language repositories and generate prioritized cleanup reports.