Agent skill · data analytics · microsoft
agent-host-logs
Analyze Agent Host debug log exports. Use when given an ah-logs or ahp-logs zip/folder, an Export Agent Host Debug Logs bundle, events.jsonl, AHP JSONL transport logs, Agent Host.log, remote-agenthost.log, or copilot-logs.
Why this skill is useful
Provides specific analysis procedures and insights into interpreting Agent Host debug logs that the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 188,455 stars on the source repository.
What this skill does
Agent Host Debug Logs Use this skill to orient to bundles produced by Developer: Export Agent Host Debug Logs.... These are different from the normal timestamped Code OSS log directory. Treat the bundle as sensitive: it can contain tokens, prompts, file contents, terminal output, paths, and settings. Keep analysis local and avoid quoting secrets or unrelated user content. Timestamps, event names, IDs, status values, and general property values are fine. Open the Bundle The export name usually starts with ah-logs and may be a zip or an already-unpacked folder. For a zip, use the bundled extractor: The final line gives the temporary extraction path. Work from that folder and delete only that exact folder when finished. Desktop ZIP exports keep host-owned logs compressed inside host-logs.zip, alongside the client-owned logs and sidecars. If that entry is present, run the same extractor on <extracted-folder>/host-logs.zip and inspect both extraction folders. The host archive contains events.jsonl, provider logs, Agent Host process logs, and Mission Control transport logs. Folder exports place these files directly in the export folder. Exports remain cancellable while collecting and saving logs. The final destination swap disables Cancel until it finishes or restores the previous export. If restoration fails, the error identifies the backup holding the previous export. Partial host-log collection or copying produces a warning alongside the saved client logs. Files are collected best-effort, so a valid bundle may contain only some of these: What the Files Mean The basic flow is: Path What it shows --- --- host-logs.zip Compressed host-owned portion of a desktop export. Extract it separately to access the host files described below. events.jsonl Persisted Copilot SDK events for the selected session: turns, messages, tools, permissions, hooks, skills, and subagents. It can cover a much longer period than the other logs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills microsoft/agent-host-logs