Skip to main content

Documentation Index

Fetch the complete documentation index at: https://braintrust.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

bt view is an interactive terminal UI for browsing logs, traces, and spans. Use it to inspect individual requests, drill into LLM conversation threads, and navigate span hierarchies. 
bt view logs                                    # Browse project logs
bt view logs --window 30m                       # Last 30 minutes
bt view logs --list-mode spans                  # One row per span instead of per trace
bt view logs --search "error"                   # Full-text search
bt view logs --url <braintrust-url>             # Jump to a specific view
bt view trace --url <braintrust-url>            # Open a specific trace
bt view span --url <braintrust-url>             # Open a specific span

​
Keyboard shortcuts

KeyAction
↑ / ↓Navigate rows
EnterOpen trace
/Edit search
rRefresh
tToggle span / thread view
← / →Switch detail panes
Ctrl+k, EnterOpen current item in browser
Backspace / EscGo back
qQuit

​
Flags

FlagDescription
--window <DURATION>Relative time window (e.g. 30m, 3d; default: 1h)
--since <TIMESTAMP>Absolute lower bound (overrides --window)
--search <TEXT>Free-text search
--filter <EXPR>BTQL filter expression
--list-mode <MODE>summary (default) or spans — one row per span
--limit <N>Rows to fetch (default: 50)
--url <URL>Open a specific Braintrust URL directly
--non-interactivePrint results without the interactive interface
--object-ref <REF>Target a specific object (project_logs:<id>, experiment:<id>, dataset:<id>)