AI Detection and Session Status
Check the session state in the hover card.
Availability
Partially implemented in stable. Read the limits below before relying on this workflow.
Reviewed against stable v0.5.1. Rust candidate additions are labeled separately. Release status.
The pain this solves
- Switching tabs to inspect agent state interrupts work.
- A simplified tab icon cannot communicate every session state.
What ships with it
- The hover card labels Idle, Done, Running, Approval, Waiting, Stuck, and Exited.
- The tab icon can be bright while running and dim otherwise when icons are enabled.
- Status detail depends on state and integration signals available for that session.
Questions this answers
- How do I know when Claude Code is done in my terminal?
- Is there a visual indicator for AI agent status in terminal?
- Terminal tab status for running AI sessions
- How to see if my AI coding agent is still working?
How it works
The tab hover card maps the session’s effective status to labels including Idle, Done, Running, Approval, Waiting, Stuck, and Exited. These are presented in the hover card rather than as a three-state badge on every tab.
The tab bar can also show an available AI logo when tab icons are enabled. Its opacity is brighter when the session is running and dimmer otherwise; it does not distinguish all seven hover-card states.
Status depends on state Chau7 has for that terminal session and recognized integration events. The implementation does not guarantee identical state precision for every CLI or infer “waiting” solely from process CPU activity.
Why it matters
A hover card can tell you whether a tracked session is running, waiting, done, or in another recognized state without relying on an unsupported universal badge. The tab icon offers a simpler running-versus-not-running visual cue when enabled.
Frequently asked questions
Which detailed states are shown?
The hover card includes Idle, Done, Running, Approval, Waiting, Stuck, and Exited.
Does the tab bar show all of those states?
No. The optional AI icon is bright while a session is running and dim otherwise. The detailed status label appears in the hover card.
Does this work identically for every AI CLI?
No. The display uses Chau7’s effective session status, which can depend on the integration and events available for a CLI.