| name | trace |
| description | Show Omagy agent flow trace timeline and summary. |
Trace
Use this skill when the user asks what happened in the current Omagy session,
which modes ran, or wants a timeline/summary of agent activity.
Execution Contract
Prefer the structured MCP tools when they are available:
- Call
omagy_trace_timeline for recent timeline entries.
- Call
omagy_trace_summary for aggregate counts and mode lifecycle data.
If MCP tools are not available, use the CLI fallback:
omagy trace timeline --json
omagy trace summary --json
For a focused recent view:
omagy trace timeline --input '{"last":20,"filter":"all"}' --json
Reporting
Report:
- recent hook/tool events first;
- active or recently completed modes next;
- metrics and gaps last.
Be explicit when trace data is missing. A missing .omagy/logs/ directory means
there are no recorded hook events yet, not that no work happened before trace was
installed.