forge-agent-obs

Overview ¶

forge-agent-obs — Bubble Tea TUI for real-time agent call observability.

Reads $FORGE_HOME/logs/agent-calls.jsonl and displays a live multi-pane dashboard:

Left pane  — scrollable call list (timestamp, agent, provider, status, latency)
Right pane — detail view of selected call (full fields + input/output previews)
Bottom bar — stats: total calls, ok/error counts, avg latency, provider breakdown
Header bar — filter bar (type to filter by agent/provider/status)

Keybindings:

j/k or ↑↓   navigate list
/           enter filter mode
Esc         clear filter
r           reload log from disk
t           toggle tail mode (auto-scroll to newest)
e           export filtered view to ~/.forge-os/logs/agent-calls-export-<ts>.jsonl
d           toggle detail pane
q / Ctrl+C  quit