Multiple agents
When several sessions are active, Heard ranks events by importance. A blocked session or a decision waiting on you can speak before routine progress from another session, while background work is summarized.
How routing works
Heard considers signals such as:
- A question or approval waiting on you
- A failed command or test
- A blocker that prevents the session from continuing
- A final result or completed task
- Routine progress that can wait for a later summary
Heard says the project name when it moves from one project to another, so you always know which session is talking.
See every session
Open Home in Heard Settings to see your live sessions as cards. Click a card to jump to that session’s window.
Talk to one session (Power)
Hold right ⌘ and start with the agent’s name, for example “Claude, run the tests again”, and Heard delivers your words to that session. If more than one session matches, Heard asks which one you mean. To hear where things stand across sessions, ask Heard Parrot to catch you up, or ask whether anything needs you.
On your iPhone, the companion app shows every session in one thread with a picker for each.
Pin a session (open source engine)
The open source engine’s menu bar app lists sessions under Active agents. Click a session to pin it when it should have your full attention, and click it again to return to automatic ranking.
Give a project a spoken name
Add a label to the project level .heard.yaml file when the folder name is unclear:
Heard uses that label when it announces the project.
Focus mode pairs well with parallel work because routine progress stays quiet while decisions, blockers, and failures still reach you.