🌲 jtree

Display Jaeger traces as a hierarchical tree in your terminal. The compact output is ideal for piping to LLM CLI agents, enabling AI-assisted trace analysis without overwhelming context.

Usage

# Basic usage
jtree <trace-id>

# Pass a full Jaeger URL directly
jtree http://localhost:16686/trace/abc123def456

# Filter to slow error spans
jtree -min-duration 100ms -error <trace-id>

# Verbose JSON output with all tags
jtree -json <trace-id>

LLM Integration

Pipe trace data directly to LLM CLI agents for AI-assisted debugging:

jtree abc123 | claude "What's causing the latency in this trace?"
jtree -error abc123 | claude "Explain these errors and suggest fixes"

Output

Default human-readable format:

call-abc123 [orchestrator] 16:43:33.529 55.47s
  stt.websocket.connect [orchestrator] 16:43:33.539 810.76ms
  conversation.turn.bot [orchestrator] 16:43:41.178 3.11s
    tts.turn [orchestrator] 16:43:41.179 3.11s
      tts.reader [orchestrator] 16:43:41.179 3.11s

With -relative:

call-abc123 [orchestrator] +0us 55.47s
  stt.websocket.connect [orchestrator] +9.94ms 810.76ms
  conversation.turn.bot [orchestrator] +7.65s 3.11s

JSON format (-json):

call-abc123 {"duration":"55.47s","service":"orchestrator","span_id":"f1f173a9f8639951","tags":{...}}

Installation

Homebrew (macOS/Linux)

brew install tomarrell/tap/jtree

Go

go install github.com/tomarrell/jtree@latest

Binary

Download the latest binary from the releases page.

Flags

| Flag | Default | Description | |------|---------|-------------| | -url | http://localhost:16686 | Jaeger URL | | -json | false | Output verbose JSON with all tags | | -min-duration | 0 | Only show spans with duration >= value (e.g. 100ms, 1s) | | -error | false | Only show error spans and their ancestors | | -service | | Only show spans from this service | | -depth | 0 | Limit tree depth (0 = unlimited) | | -relative | false | Show timestamps relative to trace start | | -version | false | Print version and exit |

License

MIT