feat: views and panes, every panel in four sizes, and the MCP servers panel

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+### Added
+- **Views and panes: every panel in four sizes.** The popups (`l` slowest tools, `f` failed tool calls, `a` advice) no longer have to share one terminal with the table. `Enter` on a popup fills the terminal with the panel: every row, scrolled with `j` `k` and the page keys, `Esc` or the panel's key back to the table, the other panels' keys still opening popups over it. `agent-top slow`, `agent-top fails`, `agent-top advice` and `agent-top mcp` start on that panel alone, with the same keys and the run's flags given before the command (`agent-top --replay snap.json mcp`); a dedicated view does not ask the upgrade question, leaving it to the main one. Inside tmux, zellij, WezTerm or kitty, a popup offers `o`: it splits a pane to the right and starts the dedicated command in it with this run's `--interval-ms`, `--stopped-window-min` and `--replay` (made absolute), keeps the focus where it was under tmux and kitty, closes the popup because the pane now shows it, and reports the result in the footer for a few seconds. The popup shows the exact command before it is pressed; the multiplexer is recognised from `$TMUX`, `$ZELLIJ`, `$WEZTERM_PANE` or `$KITTY_WINDOW_ID`, tmux first when nested. This is the second thing agent-top starts of its own accord after the upgrade: itself, in the user's multiplexer, on one keypress. The frame of every panel names its command in the bottom right corner.
+- **`m`: the MCP servers panel.** The detail pane lists one agent's servers; this panel lists the machine's: one row per server under every agent on screen (agent, server, pid with `?` for a match by elimination, calls, errors, last call, CPU, memory), then the orphaned MCP processes with where each came from.
+
+### Changed
+- The help popup gains a `panels` section, and the footer shows `m mcp` beside the other panel keys. When a panel fills the terminal the footer shows scroll, `Esc table`, and `o open in pane` when there is a multiplexer.
+
 ## [0.16.0] - 2026-09-11
 
 ### Added

README.md

@@ -47,7 +47,7 @@ What to look at first:
 - **COST** is what each session has spent so far, at list price.
 - **Red rows in the detail pane** are MCP servers whose agent has gone: a leak, and one agent-top watches for on every tick.
 
-Keys: `j`/`k` move, `Tab` switches the detail pane between the process tree and the tool trace, `s` sorts, `x` hides stopped sessions, `l` opens the slowest-tools panel, `f` the failed-tools panel, `a` the advice panel, `?` shows the rest, `q` quits.
+Keys: `j`/`k` move, `Tab` switches the detail pane between the process tree and the tool trace, `s` sorts, `x` hides stopped sessions, `l` opens the slowest-tools panel, `f` the failed-tools panel, `a` the advice panel, `m` the MCP servers panel, `?` shows the rest, `q` quits. `Enter` on a panel fills the terminal with it; inside tmux, zellij, WezTerm or kitty, `o` opens it in a new pane. See [Views and panes](https://agent-top.pages.dev/views-and-panes/).
 
 Other ways to run it:
 
@@ -194,6 +194,19 @@ time, with calls, total, average and max) and `f` for **failed tool calls**
 (ranked by failures, with the fail rate). Each closes with the same key or
 `Esc`, and is accented amber or red so you know which one is open.
 
+### Views and panes
+
+Every popup (`l`, `f`, `a`, and `m` for the MCP servers under every agent)
+comes in four sizes. The popup over the table is for a quick look. `Enter`
+on it fills the terminal with the panel, every row, scrollable, `Esc` back.
+`agent-top slow`, `agent-top fails`, `agent-top advice` and `agent-top mcp`
+start on that panel alone, for a second window or a pane you split yourself.
+And inside tmux, zellij, WezTerm or kitty, `o` on a popup splits a pane to
+the right and starts that command in it, with this run's flags; the popup
+shows the exact command before you press anything. What runs, per
+multiplexer, is in the docs:
+[Views and panes](https://agent-top.pages.dev/views-and-panes/).
+
 ### Advice
 
 Everything above is a meter. Press `a` and agent-top reads it for you: a
@@ -432,6 +445,7 @@ agent-top                        # interactive, refreshes every second
 agent-top --interval-ms 500      # faster refresh
 agent-top --stopped-window-min 120   # keep stopped sessions visible for two hours
 agent-top --replay snap.json     # render a saved --json snapshot, keys and all, reading nothing local
+agent-top slow | fails | advice | mcp   # start on that panel alone, for a second pane or window
 agent-top trace --session <id|prefix|path> [--format chrome|otlp] [-o FILE] [--endpoint URL]
 agent-top report [--since 7d|all|YYYY-MM-DD] [--by harness|model|project|day] [--json]
 ```