watchtower show
View a saved trace file with interactive navigation
Usage
watchtower show [trace]
Arguments
| Argument | Description | Default |
|---|---|---|
| trace | Trace identifier (see Trace Resolution below) | last |
Examples
# View the most recent trace watchtower show last # View by run ID watchtower show abc123 # View by full filename watchtower show 2024-01-15_abc123 # View a specific file path watchtower show ./my-traces/trace.jsonl watchtower show /absolute/path/to/trace.jsonl
Interface
┌─────────────────────────────────────────────────────────────┐
│ watchtower • Run: abc123 • my_agent • 2024-01-15 14:32:01 │
├─────────────────────────────────────────────────────────────┤
│ Summary │
│ Duration: 4.2s LLM: 3 Tools: 5 Tokens: 2,847 Errors: 0 │
├─────────────────────────────────────────────────────────────┤
│ Events 15 total│
│ ↑ 2 more above │
│ +0ms ▶ run.start my_agent │
│ > +12ms → llm.request gemini-2.0-flash │
│ +847ms ← llm.response 1,203 tokens 835ms │
│ +850ms ⚙ tool.start search_web │
│ ↓ 8 more below │
├─────────────────────────────────────────────────────────────┤
│ ↑↓/jk Navigate Enter Expand g/G Start/End q Quit │
└─────────────────────────────────────────────────────────────┘
Event Detail View
Press Enter on any event to expand it:
┌─────────────────────────────────────────────────────────────┐
│ Event Details │
│ │
│ Type: llm.response │
│ Timestamp: 2024-01-15 14:32:01.847 │
│ │
│ Request ID: req_001 │
│ Duration: 835ms │
│ Input Tokens: 523 │
│ Output Tokens: 680 │
│ Total Tokens: 1,203 │
│ Tool Calls: Yes │
│ Finish Reason: tool_calls │
├─────────────────────────────────────────────────────────────┤
│ b/Esc Back q Quit │
└─────────────────────────────────────────────────────────────┘
Keyboard Shortcuts
| Key | Action |
|---|---|
| ↑ / k | Move up |
| ↓ / j | Move down |
| Page Up / u | Page up |
| Page Down / d | Page down |
| g | Jump to first item |
| G | Jump to last item |
| Enter | Expand event details |
| b / Esc | Go back |
| q | Quit |
Trace Resolution
The show command accepts several formats for identifying traces:
| Format | Example | Description |
|---|---|---|
| Keyword | last | Most recently modified trace |
| Run ID | abc123 | Search for *_abc123.jsonl |
| Filename | 2024-01-15_abc123 | Date and run ID |
| Path | ./traces/trace.jsonl | Relative or absolute path |