Getting started

Pill, panel, and menu bar

AgentPeek lives in three surfaces: a compact pill, an expanding panel, and an optional menu bar item.

The pill#

The pill is the compact, always-on bar under the notch. It shows glanceable status: an active-session count or live usage gauges, depending on your Appearance settings. It never steals focus and never covers your work.

  • Keep it always visible, hide it when idle, or show it only while expanded.
  • Keep it always on as usage gauges, with up to four agents promoted by the Collapsed usage setting.
  • Widths, density, glass depth, and opacity are all adjustable in Appearance settings.

The panel#

Click the pill, or let it open on its own, and the panel expands. It's the working surface for everything live: sessions, permission and question prompts, plans, token usage, and local servers. The Pages menu in the panel header also opens Quick Routes, Fast Actions, Views, and the Agent Board.

AgentPeek can auto-expand the panel when an agent needs attention, so a permission prompt or question arrives already laid out instead of sitting unnoticed in a background terminal. A global hotkey toggles the notch open and closed from anywhere.

Displays and layout#

You choose which displays show the notch surface, and floating widgets can sit on any display, external ones included. Appearance settings cover expanded and collapsed widths, density, text size, session-list sizing, glass depth, opacity, per-agent avatar colors, and per-tool colors, so the surface reads the way you want it to.