---
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:

1. Call `omagy_trace_timeline` for recent timeline entries.
2. Call `omagy_trace_summary` for aggregate counts and mode lifecycle data.

If MCP tools are not available, use the CLI fallback:

```bash
omagy trace timeline --json
omagy trace summary --json
```

For a focused recent view:

```bash
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.