Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Agent view

Press T to toggle. The column set changes from the process-manager default to one optimised for Claude and Codex sessions.

Default layout

PID | Name | CPU% | Memory | Status | Command | Uptime

The neutral process-inspector view. Unchanged from traditional top-style tools; useful for spotting runaway child processes.

Agent layout

PID | Name | Status | Ctx% | Cost | Tokens | Tool | Uptime

Codex and non-agent rows render in the telemetry columns so the row still reads cleanly.

Cell semantics

Status

One of: processing, needs_input, waiting_input, idle, finished, unknown. Inferred from a priority hierarchy (CPU > pending-tool > last stop reason > timestamp age) so a busy session never reads as Idle just because its transcript lags.

Ctx%

Live context-window utilisation for the most recent turn.

ValueColour
< 50%green
50 – 79%yellow
≥ 80%red

Absent sessions (e.g. very fresh) render as dim .

Claude: sum of input_tokens + cache_creation_input_tokens + cache_read_input_tokens from the most recent assistant message, divided by the model's context window (looked up from the pricing table).

Codex: last_token_usage.input_tokens / model_context_window, both read verbatim from the rollout file.

Cost

Session-cumulative USD estimate.

ValueColour
< $1green
$1 – $5yellow
> $5red

Both providers compute cost locally from a model pricing table, flagged cost_is_estimated: true in the JSON output. See the Claude and Codex chapters for audit dates.

Tokens

Combined {in_k}k↑ {out_k}k↓, cumulative across the session. No colour thresholds — interpretation depends on pricing tier.

Tool

Truncated name of a pending tool call (at most 10 chars, ellipsis if longer). Bold yellow when pending; empty otherwise.

Interaction with other toggles

T is orthogonal to F (focus filters), g (project grouping), and / (free-text filter). Any combination is valid. The default state (all toggles off) is the classic process-inspector view.

Why a toggle, not always-on

Claude and Codex telemetry columns are only meaningful for agent rows. Showing them as permanent columns would either waste screen width on cells for every shell and subprocess, or crowd out the process-manager fundamentals. Toggling keeps both modes sharp.