agent trace list
List the available trace files that were recorded during all agent preview sessions.
When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. By default, this command lists all trace files for all agents and all of their sessions. Use flags to narrow results: filter by agent name (–agent), by session (–session-id), or by date (–since).
Each row in the output corresponds to one trace file, which in turn corresponds to one agent session. The Agent column shows the authoring bundle or API name used when starting the session.
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
‑‑agent | ‑a | Type: Value API name of the agent used to filter the list of available trace files. Matches against the API name used when starting the session, either an authoring bundle or a published agent API name. |
‑‑flags‑dir | N/A | Type: Value Import flag values from a directory. |
‑‑json | N/A | Type: Boolean Format output as json. |
‑‑session‑id | N/A | Type: Value Session ID used to filter the list of trace files. Use the “agent preview sessions” CLI command to list all known agent preview sessions along with their session IDs. |
‑‑since | N/A | Type: Value Date used to filter the list of trace files; only those recorded on or after the date are listed. Accepts ISO 8601 format: date-only (2026-04-20), date-time (2026-04-20T14:00:00Z), or date-time with milliseconds (2026-04-20T14:00:00.000Z). The “Recorded At” values shown in the table output are valid inputs. |
List all trace files for all agents and sessions:
List all trace files for a specific agent:
List trace files for a specific session:
List trace files recorded on or after April 20, 2026 (date-only, interpreted as UTC midnight):
List trace files recorded on or after a specific UTC time:
Filter by agent and date together:
Return results as JSON: