GUIDE
How to monitor multiple Claude Code sessions at once
To watch several parallel sessions without alt-tabbing, you need each agent's live state in one place - working, idle, or asking - since the hard part of running agents in parallel isn't launching them, it's knowing which one needs you.
What there is to know, and where it lives
Every agent CLI is an ordinary process: your process list already knows which agents are running, in which directory, under which terminal. Claude Code goes further - it writes a local transcript (~/.claude/projects/…) as it works, which carries the session title, the last exchange, and what tool it’s touching right now.
The states that matter
- Working - burning CPU (the agent or its build subprocesses) or actively writing its transcript.
- Idle - finished or waiting for your next message. Not an emergency.
- Asking - a permission prompt is up. The only state that deserves a ping.
How NapCat shows it
NapCat samples the process list every few seconds and reads Claude Code’s local transcripts, read-only. Every session becomes a live card in the notch - task, last exchange, model, terminal - with a bar that says Working… in blue while anything runs. Click a card and it lands on the session’s exact terminal tab in Terminal, iTerm2, or Warp.
Questions
How can I see all my Claude Code sessions in one place?
NapCat samples your Mac's process list every few seconds and reads Claude Code's local transcripts read-only, showing each session as a live card in the notch with its task, last exchange, model, and terminal.
Which session states does it show?
Three: Working (burning CPU or actively writing its transcript), Idle (finished or waiting for you), and Asking (a permission prompt is up). Only the Asking state really deserves a ping.
Does it work with agents other than Claude Code?
Yes. NapCat recognizes 27+ coding agents including Codex and Gemini CLI from the process list. Claude Code gets the richest detail because it writes a local transcript NapCat can read.
Can I jump straight to the session that needs me?
Click a card and NapCat brings that session's exact terminal tab forward in Terminal, iTerm2, or Warp, so you land on the run that stopped instead of hunting through windows.
Related
See how to approve Claude Code from the menu bar, set up Claude Code notifications, or read the full Claude Code support page.
Keep AI coding sessions in sight from your Mac’s notch - $7.99, once.
Download - free 2-day trial