Repository navigation
v0.34.0
apogee — v0.34.0 — 2026-11-10
This release adds a side panel beside the conversation on wide terminals, showing live sub-agents, tasks, changed files, usage and MCP servers, along with a new /mcp report and quicker notice when an MCP server goes away. It also lets advice Reactions speak just before a request is sent, and gives a long prompt draft a scroll bar.
New
- A side panel beside the conversation — on a terminal 137 columns wide or more (117 with
ui.side-panel.show: on), a column to the right of the transcript shows your sub-agents, the task list, the files changed this session, usage and MCP servers, and readsnothing livewhen idle. Clicking a row opens what it names — a sub-agent's Run view, the task card, a changed file's edit or/usage— the panel follows the run you are viewing, and a resumed session gets its tasks, changed files and usage back. - Choose when the side panel shows and what it holds —
ui.side-panel.show(auto,onoroff) decides when it is drawn, andui.side-panel.sectionssets each section's order and whether it ispinned,autoorhidden. Both apply straight away, and/settingssaves the show setting to~/.apogee/config.yaml. /panelcontrols the side panel from the prompt —/panel on|off|autosets when it shows and/panel pin|unpin|hide <section>sets one section, each saved to your global config. A bare/panelreports the current modes, even mid-run, and says when the window is too narrow to dock the panel.- Resize the side panel — drag the panel's separator to resize it live (the new width is saved as
ui.side-panel.width, 24 columns or more, default 44), double-click it to go back to the default, or type/panel width <n>or/panel width reset. A width you choose can narrow the conversation to as few as 60 columns. - Fold and pin side-panel sections — click a section's title to fold it to one line or open it again, and the choice is remembered in
ui.side-panel.folded; click the●/○at the start of a header to pin or unpin it. A section folded because the window is short shows▶, and a click opens it for the rest of the session without touching your config. - The keyboard reaches the side panel — in navigation mode (
⌥↑/⌥↓),→moves into the panel and←back,⏎on a row does what a click would (a header has two stops: its pin and its title), and^xon a sub-agent row stops that run./help's key legend now lists these keys. - The side panel on a narrow window — when the window is too narrow to dock the panel, a bare
/panelor→in navigation mode opens it over the right edge of the conversation.←,escor a click outside it closes it again. - Sub-agent rows show when a run is waiting on you — while a sub-agent's approval is open, its side-panel row reads
waitingunder◷(?withui.glyphs: safe) in the warning colour until the question is settled or the run ends. Long runs keep the rows aligned, with clocks such as1h02mand1d02h, and the running spinner cycles through the sameui.spinner-colorcolours as the status line's. - The side panel looks like the rest of the screen — headers read like the transcript's block headings, with short summaries such as
(2 · 1 queued), a failure such as a sub-agent's or MCP server'sfailedshows in the transcript's red (as/mcpshows it too), and usage reads figures-then-bar like the status-line gauge, never over 100%. The panel starts one row below the top edge, lines up with the status line, and its separator is as quiet as the scroll track. ui.glyphs: safecovers the side panel — with safe glyphs on, the panel uses•for a pinned section,>for the current task and the viewed run, and»for a file a sub-agent wrote. The manual'sui.glyphsentry now lists every shape that looks the same in both sets./mcpshows your MCP servers — a new report, closed withesc, lists every MCP server with its transport, whether it comes from your global or project config, its state, its tool count and, for a failed one, why it failed; it stays live while open, during a Turn and while watching a session. The side panel gains a matching MCP section that appears while any server is not connected and opens/mcpon a click; because/mnow completes to/mcp, type/mofor/model.- Advice Reactions can fire just before a request is sent — an
advise:Reaction can now useon: [pre-request]oron: [post-response], and its answer is attached to the next outgoing request only, never saved into the conversation, and switched off under Bypass./advicelists these firings, andapogee probe context --livecounts pre-request advice in its first-Turn reading. - A scroll bar for long prompts — once a draft is longer than the prompt box can show, a scroll bar appears on the box's right edge (hidden by
ui.show-scrollbar: falselike the others). The mouse wheel over the box now scrolls the draft instead of the conversation. - More detail in headless JSON output —
apogee headless --format jsonwrites atask_listline each time an agent's task list changes (sub-agents included) and acontext_costline at the end of every Turn, and eachsub_agent_phaseline now carries the time it happened asdata.at. - MCP server state for programs that embed apogee — the Event stream now reports each MCP server's lifecycle (
dialling,connected,failed,disconnected) asapogee.MCPServerEvent, also written asmcp_serverlines in the interactive session's journal, andapogee.SerializeEventslets an embedding program send its own Events through the engine's ordered sink.
Improved
- apogee notices a lost MCP server at once — when an MCP server exits, crashes or drops its connection mid-session, apogee no longer waits for the next tool call to find out: it withdraws the server's tools,
/mcpand the side panel readdisconnected (lost)with the cause, and the conversation gains one line saying so. It does not reconnect on its own; retry from themcp-serversrow in/settings. - Clearer sub-agent and task labels in the conversation — a delegation's block is now headed
Sub-agent, a group of themSub-agents (N)and the task cardTasks (done/total), and a delegation waiting for a free slot readsqueuedinstead ofscheduled. Resumed sessions show the new labels too. - The navigation cursor shows without colour — the row the navigation-mode cursor stands on now also starts with a
▌, so you can see where it is on a terminal that shows no colour.
Fixed
- Small models' sub-agent calls no longer waste a Turn — a
sub_agentcall whosetoolsis["read-only"], or a list of tool names sent as a quoted string, now runs instead of being refused, andfan_outand workflow stagetools:accept the same forms. Afan_outwith an unknown tool name, or one that mixesread-onlywith tool names, is now refused with a clear message before any helper starts. /settingspointer hints stay on screen — a long setting value no longer pushes hints such as· ⏎ opens $EDITORoff the edge of the pane; the value is cut short with…instead, while the row you are editing still shows it whole.- Windows: a session journal that cannot be removed is reported — when a session ends and its journal file cannot be removed for any reason other than a session watcher still holding it open, the "session journal stopped" notice now says so instead of the file being left behind silently.
Docs & install
- The manual explains the side panel — the configuration manual gains a side-panel section covering when it shows, what each section's rows mean, clicks, resizing, the narrow-window overlay, the keyboard, and watching and resuming sessions.