Skip to content

v0.34.0

Choose a tag to compare

@airiclenz airiclenz released this 10 Nov 13:35
· 188 commits to main since this release

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 reads nothing live when 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, on or off) decides when it is drawn, and ui.side-panel.sections sets each section's order and whether it is pinned, auto or hidden. Both apply straight away, and /settings saves the show setting to ~/.apogee/config.yaml.
  • /panel controls the side panel from the prompt — /panel on|off|auto sets when it shows and /panel pin|unpin|hide <section> sets one section, each saved to your global config. A bare /panel reports 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 ^x on 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 /panel or → in navigation mode opens it over the right edge of the conversation. ←, esc or 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 waiting under ◷ (? with ui.glyphs: safe) in the warning colour until the question is settled or the run ends. Long runs keep the rows aligned, with clocks such as 1h02m and 1d02h, and the running spinner cycles through the same ui.spinner-color colours 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's failed shows in the transcript's red (as /mcp shows 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: safe covers 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's ui.glyphs entry now lists every shape that looks the same in both sets.
  • /mcp shows your MCP servers — a new report, closed with esc, 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 /mcp on a click; because /m now completes to /mcp, type /mo for /model.
  • Advice Reactions can fire just before a request is sent — an advise: Reaction can now use on: [pre-request] or on: [post-response], and its answer is attached to the next outgoing request only, never saved into the conversation, and switched off under Bypass. /advice lists these firings, and apogee probe context --live counts 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: false like 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 json writes a task_list line each time an agent's task list changes (sub-agents included) and a context_cost line at the end of every Turn, and each sub_agent_phase line now carries the time it happened as data.at.
  • MCP server state for programs that embed apogee — the Event stream now reports each MCP server's lifecycle (dialling, connected, failed, disconnected) as apogee.MCPServerEvent, also written as mcp_server lines in the interactive session's journal, and apogee.SerializeEvents lets 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, /mcp and the side panel read disconnected (lost) with the cause, and the conversation gains one line saying so. It does not reconnect on its own; retry from the mcp-servers row in /settings.
  • Clearer sub-agent and task labels in the conversation — a delegation's block is now headed Sub-agent, a group of them Sub-agents (N) and the task card Tasks (done/total), and a delegation waiting for a free slot reads queued instead of scheduled. 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_agent call whose tools is ["read-only"], or a list of tool names sent as a quoted string, now runs instead of being refused, and fan_out and workflow stage tools: accept the same forms. A fan_out with an unknown tool name, or one that mixes read-only with tool names, is now refused with a clear message before any helper starts.
  • /settings pointer hints stay on screen — a long setting value no longer pushes hints such as · ⏎ opens $EDITOR off 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.