How do I control Claude Code with my voice?

NovaHUD finds every Claude Code session running on your Mac (and Codex sessions active in the last 30 minutes) and listens for you to address one.

What can I say?

• "Nova, what is Life OS working on?" — answered instantly from what the session last did, no model call.
• "Tell Claude to keep working on Life OS." — delivered to the Life OS session.
• "Tell Fade to run the tests." — addressed by name.
• "Everyone, pull the latest." — sent to every running session.
• "Ask Life OS what it's blocked on." — a question, answered out loud.

Does Nova announce everything my sessions do?

Not by default. Nova keeps track and reports when you ask: "Nova, catch me up", "any updates?" or "report". To hear updates as they happen, turn on Settings › Notch › Speak session updates as they happen.

Can Nova answer questions about what's on my screen?

Yes. Ask "Nova, what's this error?", "explain this" or "what am I looking at?". NovaHUD captures the display you're on, reads its text on your Mac with Apple's Vision, and Nova answers from that text. The screenshot never leaves the app. macOS asks for Screen Recording permission the first time.

Can Nova keep a to-do list?

Yes. Say "Nova, remind me to send the invoice" or "add call the bank to my to-do list", and it appears in the To do tab.

How does NovaHUD know which session I mean?

It matches the session's nickname, its project folder name (so "LifeOS" matches a folder called LIFE OS even without the space, and worktree sessions are matched by their project, not the worktree's random name), the session's title, and distinctive words from the title. If you name a project that has no running session, Nova tells you what is running instead of guessing. If you say "tell Claude to…" without naming a project, it goes to the session you last talked to or the one in focus.

Does NovaHUD send instructions without asking?

By default Nova reads the instruction back — "Sending to Life OS: keep working. Say stop to cancel." — and sends it after seven seconds unless you say stop, no or cancel. Saying yes sends it immediately. You can turn the read-back off in Settings.

Why does Nova answer some things and send others?

Questions ("what's it doing?", "is the build passing?") are answered by Nova. Instructions ("fix", "run", "add", "keep working") are delivered to the session. "Tell/ask/have Claude to…" is always treated as an instruction.

Do I have to say "Nova" every time?

No. For 20 seconds after Nova answers you, anything you say counts as a reply. After an update Nova volunteered on her own, that window is 8 seconds, so conversation in the room is not mistaken for instructions.

How do I know Nova heard me?

The notch shows an ear with a spinner the moment she recognises you addressed her, and animated bars with a glow the whole time she is speaking.

Can I type instead of talking?

Yes. On Home, pick a session and type into the message field; typed messages are sent without a read-back. You can also search for any session from Home's search bar or with ⌘K.

Also available as Markdown · All docs in one file: llms-full.txt