CLI Reference

pip install arzule-ingest

arzule --help

arzule view <file> [options]

# Timeline view (default)
arzule view traces.jsonl

# Table format
arzule view traces.jsonl -f table

# JSON output (for piping to other tools)
arzule view traces.jsonl -f json

# Filter by run
arzule view traces.jsonl --run-id abc123

# Filter by event type
arzule view traces.jsonl --event-type "tool.*"

Run: 550e8400-e29b-41d4-a716-446655440000
Started: 2025-12-24T10:30:00.000Z

10:30:00.000  run.start
10:30:00.100  crew.kickoff.start
10:30:00.150  ├── agent.execution.start [Researcher]
10:30:00.200  │   ├── llm.call.start
10:30:01.500  │   └── llm.call.end (1.3s)
10:30:01.600  │   ├── tool.call.start [WebSearch]
10:30:02.100  │   └── tool.call.end (0.5s)
10:30:02.200  └── agent.execution.complete
10:30:02.300  crew.kickoff.complete

Duration: 2.3s | Events: 10

| Timestamp           | Event Type              | Agent      | Status |
|---------------------|-------------------------|------------|--------|
| 10:30:00.000        | run.start               | -          | ok     |
| 10:30:00.100        | crew.kickoff.start      | -          | ok     |
| 10:30:00.150        | agent.execution.start   | Researcher | ok     |
| 10:30:00.200        | llm.call.start          | Researcher | -      |
| 10:30:01.500        | llm.call.end            | Researcher | ok     |

arzule stats <file>

Trace Statistics: traces.jsonl
==============================

Runs:           3
Total Events:   847
Time Range:     2025-12-24T10:00:00Z to 2025-12-24T11:30:00Z

Events by Type:
  run.start                  3
  run.end                    3
  crew.kickoff.start         3
  crew.kickoff.complete      3
  agent.execution.start     12
  agent.execution.complete  12
  tool.call.start           45
  tool.call.end             45
  llm.call.start           180
  llm.call.end             180

Agents:
  Researcher    245 events
  Writer        312 events
  Reviewer      290 events

Average Run Duration: 4m 32s
Average Events/Run:   282

arzule validate <file>

Validating: traces.jsonl

Checked 847 events
Schema version: trace_event.v0_1
Status: VALID

No errors found.

Validating: traces.jsonl

Checked 847 events
Status: INVALID

Errors:
  Line 234: Missing required field 'trace_id'
  Line 567: Invalid event_type 'unknown.event'

2 errors found.

# Count events by type
arzule view traces.jsonl -f json | jq '.event_type' | sort | uniq -c

# Extract specific run
arzule view traces.jsonl -f json --run-id abc123 > run_abc123.json

# Filter tool calls
arzule view traces.jsonl -f json | jq 'select(.event_type | startswith("tool."))'