Speaklna with Grok Build

Hear a one-sentence report when Grok Build finishes a turn, and ask it to read things aloud.

Needs the Speaklna app from the Mac App Store, opened at least once, and Node.js 18 or later.

Set it up

npm install -g speaklna
speaklna setup grok

Or without installing: npx -y speaklna setup grok. A global install is better, because the hook then points at a stable path.

Setup shows every change first and asks y/N. Originals are saved once as <file>.speaklna-bak.

What it changes

~/.grok/config.tomladds a marked block [mcp_servers.speaklna]
~/.grok/hooks/speaklna.jsona new hook file with a Stop hook
~/.grok/rules/speaklna.mda new rules file. Skipped if you already set up Claude Code, because Grok Build reads the same rule from ~/.claude/rules/

If you set GROK_HOME, the files above live there instead.

Test it

Start a new Grok Build session and let it finish one turn, for example by asking a simple question. You should hear something like “Grok Build, myproject: …”. The name after the comma is the folder you ran it in.

To check only that the app and the package are connected, run this in a terminal:

speaklna say "Hello"

If the model did not end its reply with a 🔊 (speaker emoji) line, nothing is spoken. Starting a fresh session makes it read the rule.

Ask it to read something aloud

Setup also gives Grok Build the Speaklna tools. Just ask, for example:

Read the summary above aloud.

Grok Build calls the speak tool and Speaklna reads it with your chosen voice. This is separate from the automatic report. Press ⌥S any time to stop, or ask “stop reading”.

Good to know

Reports are spoken only when a turn ends normally.
Grok Build also reads Claude Code’s MCP entry and rules, so if you already set up Claude Code, it has the speak tool before you run setup. Running setup for Grok Build adds its own hook.
Reports queue, only the newest per session is kept, and AI is quiet while another app uses the microphone. ⌥T and ⌥S always win. Details.

Uninstall

speaklna uninstall grok

It lists what it will remove for Grok Build and asks first. Only what setup added is removed.