Skip to content
Supaterm
Esc
navigateopen⌘Jpreview
On this page

Agent status and panel

Read coding-agent activity, progress, workspace context, and notifications.

Supaterm keeps agent activity visible without replacing the terminal.

The tab row reflects the foreground agent sessions across its panes:

  • Working — the agent is processing a turn or using tools.
  • Needs input — a permission request, question, or other attention event is waiting.
  • Done — a turn finished while its tab was not being viewed.

Needs input takes priority over Done, and Done takes priority over Working. Viewing the tab clears Done. A turn that finishes in the tab you are viewing does not show Done. Wide rows show the symbol and word; narrow rows show only the symbol.

Supaterm reads the terminal to set Claude, Codex, and Pi phase. Claude and Codex hooks add only session identity and workspace data. Terminal-only state is temporary and creates no session actions.

Unread badges remain available after activity ends. Viewing a tab clears its completion state.

Agent panel

Press Command-I in an agent pane. The panel can show:

  • the agent’s workspace directory
  • Git branch and changed-line counts
  • pull request state and checks
  • local web services discovered from listening ports in the agent process tree

Click the directory or branch row to copy its full value. Pull requests, checks, and local service rows open their URLs.

Supaterm agent panel showing progress, workspace, pull request checks, artifacts, and session actions.

The panel follows the foreground root agent. A child agent cannot replace its parent’s workspace or session actions.

Terminal detection supplies agent identity and activity state. Claude and Codex hooks add session actions without changing activity. Pi remains terminal-only, so its data is not saved.

Attention

Enable Settings > Notifications > Glowing Pane Ring to highlight a pane that needs attention. Enable System notifications for macOS delivery, or keep them off and choose a Notification Sound for local audio only.

Turning either presentation off does not discard unread state or badges. See notifications.

Last updated on September 1, 2026