Heard Parrot

Ask Jarvis about your codebase and hear a spoken answer.
View as Markdown

Heard Parrot turns the narrator into someone you can ask. Hold the talk key, address your narrator by name, and speak. The wake word is your narrator’s name: “Jarvis” if you use the default voice, or “Aria”, “Friday”, “Atlas” if you chose another. “Hey Parrot” always works, whichever voice is speaking.

Things you can say
"Jarvis, walk me through this codebase."
"Aria, how's the backend doing?"
"Hey Parrot, where does sign-in happen?"
"Jarvis, catch me up."
"Jarvis, open claude in checkout-service."

What Parrot can do

Parrot does exactly three things:

  1. Converse with your codebase — ask, and hear a grounded answer.
  2. Catch me up — a spoken recap of what happened while you were away.
  3. Open things by voice — the one safe action it can take.

Everything else about it is deliberate restraint — see Non-intrusive by design.

1. Converse with your codebase

Ask about the repo you are working in — architecture, behavior, where a feature lives — and Parrot runs a read-only dig through the codebase, then answers out loud.

1

Hold the talk key and say the wake word

Hold Right Command as usual and open with your narrator’s name, or “Hey Parrot”. The moment Heard hears the wake word, the pill switches from dictation to Parrot, so you can see the question is going to your narrator instead of your cursor.

2

Heard digs, then answers

Parrot explores the active repository read-only. It never edits files and never runs your coding agent. Depending on your settings, it can speak brief progress while it digs.

3

Follow up naturally

After an answer, the conversation stays open for a moment: ask follow-ups without repeating the wake word. Tap the talk key on its own to end the conversation and return the key to dictation.

2. Catch me up

Say “catch me up” and your coding companion gives you a spoken recap of what your agents did while you were away — the fastest way to get back into context after stepping out, finishing a call, or coming back to a long parallel run.

  • “Catch me up” or “what did I miss?” — a recap of the project you’re working in: what each agent did, what landed, and what is waiting on you.
  • “Catch me up on everything” — a mission-level sweep across every active project, using the same names your notch shows, with anything that needs your attention first.
  • Other phrasings work too: “fill me in”, “what’s been happening”, “what happened while I was gone”.

The recap knows how long you were away and covers exactly that window — it re-summarizes fresh rather than replaying old narration, so a two-hour absence comes back as a few sentences, not a backlog. Even lines Heard held back while you were on a call or recording fold into the next catch-up, so silence never loses information.

This is the “pull” half of an AI pair programmer that talks: narration pushes progress to you in the moment, and catch me up lets you pull the summary whenever you’re ready.

3. Open things by voice

Parrot includes a small set of safe open commands:

Safe open commands
"Jarvis, open claude in checkout-service."
"Hey Parrot, open codex in my-app."
"Jarvis, open checkout-service in Finder."

Projects in your projects folder are addressable by name, and a .heard.yaml label works here too. Opening is the only action Parrot can take — it is non-destructive, visible the moment it happens, and you can turn it off entirely in Settings, making Parrot answer-only.

Non-intrusive by design

Heard Parrot observes; it does not act on your work.

  • It never edits files, never runs your coding agent, and never executes commands in your repositories.
  • It never types into an existing session: a Parrot question is routed away from your cursor, so nothing lands in a terminal by accident.
  • Its digs through the codebase are read-only, and they run in a separate throwaway context that your agents never see.
  • The one category of action it can take is opening things (above) — and even that can be switched off.

Settings

SettingWhat it does
Answer depthBrief, Balanced, or Deep: how much codebase context Parrot speaks in its first answer.
Progress updatesWhether Parrot narrates short waypoints while it digs.
Disable safe open commandsTurns off the open-by-voice verbs, leaving Parrot answer-only.

Parrot is part of Heard Power and rides the same on-device speech recognition as dictation: hold the key, speak, release. Questions about the codebase stay read-only by design.