mayros trace
Inspect agent trace events stored in AIngle Cortex. Query, explain, aggregate, and visualize decision trees from trace data.
Global options
All subcommands accept:
--cortex-host <host>— Cortex host (default:127.0.0.1or from config)--cortex-port <port>— Cortex port (default:8080or from config)--cortex-token <token>— Cortex auth token (or setCORTEX_AUTH_TOKEN)
Subcommands
trace events
List recent trace events, optionally filtered by agent, type, or time range.
Options:
| Flag | Description |
|---|---|
--agent <id> | Agent ID to query (default: default) |
--type <type> | Filter by event type: tool_call, llm_call, decision, delegation, error |
--from <iso> | Start time (ISO 8601) |
--to <iso> | End time (ISO 8601) |
--format <fmt> | Output format: terminal, json, markdown (default: terminal) |
trace explain <eventId>
Show the causal chain leading to a specific event. Traces back through parent events to explain why an action occurred.
trace stats
Show aggregated observability statistics for an agent.
Options:
| Flag | Description |
|---|---|
--agent <id> | Agent ID (default: default) |
--from <iso> | Start time (ISO 8601) |
--to <iso> | End time (ISO 8601) |
--format <fmt> | Output format: terminal, json (default: terminal) |
trace session <sessionKey>
Build and display a decision tree from all events in a session. Shows hierarchical event relationships with timestamps, types, and details.
Options:
| Flag | Description |
|---|---|
--format <fmt> | Output format: terminal, json (default: terminal) |
trace status
Check Cortex connectivity and show server info (triple count, subject count, uptime, version).
Examples
bashmayros trace events mayros trace events --agent ops --type tool_call --format json mayros trace events --from 2025-01-01T00:00:00Z --to 2025-01-02T00:00:00Z mayros trace explain abc12345 mayros trace stats --agent main mayros trace session agent:main:default mayros trace status