speaklna

A thin command-line shell that lets AI coding tools on a Mac talk through the Speaklna app (local text-to-speech). Supported: Claude Code, Codex, OpenCode, Grok Build (grok), OpenClaw.

It does three things:

• speaklna mcp — a stdio MCP server with four tools: speak, stop, status, voices.
• speaklna hook <tool> — a turn-end hook. The model ends each reply with one line starting with 🔊; the hook reads that line and sends it to the app. Secrets are redacted, the hook never prints and always exits 0.
• speaklna setup / speaklna uninstall — write (and cleanly remove) the MCP entry, the hook and a short rules file for each tool.

AI tools can only speak, stop, check status and list voices. They cannot import voices or change settings.

Usage

npx -y speaklna setup            # detect installed tools, show every change, ask before writing
npx -y speaklna setup claude codex --yes
npx -y speaklna uninstall
speaklna say "Hello"             # also: stop, status, voices (add --json)

Notes:

• setup shows exactly which files and keys it will change and asks y/N. Originals are saved once as <file>.speaklna-bak.
• Hooks call the installed speaklna by absolute path. For a stable path run npm i -g speaklna first.
• Codex: after setup, open /hooks once inside Codex and trust the hook.
• OpenClaw: restart the Gateway if it is running. Its "can't verify where this plugin came from" warning is expected.
• Needs macOS with the Speaklna app. On other systems the commands print a message and exit 0.

Protocol between this CLI and the app: PROTOCOL.md. Tests: npm test (Node 18+, no dependencies).

License: MIT. Author: Aivmelna LLC.

中文

给 Mac 上的 AI 编程工具用的 Speaklna（本地朗读）命令行薄壳，支持 Claude Code、Codex、OpenCode、Grok Build、OpenClaw。

• speaklna mcp：MCP 服务，工具 speak / stop / status / voices。
• speaklna hook <工具>：每轮结束的钩子，只念回复最后一行以 🔊 开头的报告句；密钥类内容会先抹掉；钩子不打印、不阻塞、退出码恒为 0。
• speaklna setup / uninstall：把 MCP、钩子和“每轮结尾写一行 🔊”的规矩写进各家配置，卸载时删干净。

AI 只能念、停、看状态、列音色，改不了设置，也不能导入音色。

npx -y speaklna setup          # 自动发现已装的工具，先列出要改的文件，同意才写
npx -y speaklna uninstall

写入前会备份为 <文件>.speaklna-bak。Codex 装完要在 Codex 里打开 /hooks 点一次信任；OpenClaw 的 Gateway 开着就重启一次（会提示无法确认插件来源，正常）。