From voxclaw
Sends text to VoxClaw on macOS for spoken output using OpenAI neural voices or Apple TTS. Useful for audible agent notifications and feedback.
npx claudepluginhub malpern/voxclaw --plugin voxclawThis skill uses the workspace's default tool permissions.
Use this skill when the user wants audible output from an agent.
Uses macOS `say` command to speak responses aloud when messages start with 'User talked via voice recognition', providing voice feedback for voice wake inputs.
Delivers spoken voice summaries of task accomplishments using pocket-tts and Bash say script. For Stop hook reminders, user requests, or status updates.
Sets up and tests TTS/STT backends like sag (ElevenLabs), OpenAI TTS/Whisper, macOS say, and whisper-cli. Enables voice for agent conversations via guided flows.
Share bugs, ideas, or general feedback.
Use this skill when the user wants audible output from an agent.
VoxClaw runs on macOS as a menu bar app and can speak text through:
voxclaw CLIvoxclaw://read?text=... URL scheme4140If the human provides a VoxClaw setup pointer, use the provided health_url and speak_url directly.
Connection order:
plugins/voxclaw/scripts/voxclaw-say --health when working in this repo.speak_url or health_url to the helper.http://localhost:4140/status.voxclaw CLI when needed.Never guess a .local hostname if the user already supplied a numeric LAN IP.
Default to the helper script instead of open-coded curl:
plugins/voxclaw/scripts/voxclaw-say "Hello from the agent"
plugins/voxclaw/scripts/voxclaw-say --health
plugins/voxclaw/scripts/voxclaw-say --url http://192.168.1.50:4140/read "Deployment complete"
plugins/voxclaw/scripts/voxclaw-say --voice nova --rate 1.2 "Build failed"
plugins/voxclaw/scripts/voxclaw-say --instructions "Read warmly" "Welcome back"
plugins/voxclaw/scripts/voxclaw-say --project-id /Users/me/myproject "Update from my project"
Health check:
curl -sS http://localhost:4140/status
Speak text:
curl -X POST http://localhost:4140/read \
-H 'Content-Type: application/json' \
-d '{"text":"Hello","project_id":"/Users/me/myproject","agent_id":"my-agent"}'
Optional fields: voice, rate, instructions, project_id, agent_id.
Acknowledge (user has read the response, skip speaking it):
curl -X POST http://localhost:4140/ack \
-H 'Content-Type: application/json' \
-d '{"project_id":"/Users/me/myproject"}'
voxclaw "Hello"
voxclaw --clipboard
voxclaw --voice nova "Build passed"
voxclaw --send "Hello" # send to an already running listener
voxclaw --status