claude-can-speak 0.1.0 → 0.1.1

package/README.md

@@ -1,16 +1,22 @@
 # claude-can-speak
 
-**Now Claude Code talks back.** Speech-out for Claude Code: a companion to the
-built-in `/voice` speech-in. Turn `/voice` on and Claude can read its replies
-aloud through your speakers; turn it off and you are back to silent, text-only.
-Two ways to use it, a local neural voice, nothing sent to the cloud.
-
-- **Firehose mode** - a Stop hook speaks every finished reply while `/voice` is
-  on. One switch (`/voice`) controls both directions: you talk to it, it talks
-  back.
-- **Deliberate mode** - a `speak` skill lets Claude choose what to voice: a
-  spoken "the build is done", a heads-up while you are looking away, a shoutout.
-  Selective, on purpose, not a firehose.
+**Let Claude decide what to say out loud.** Most "speak Claude Code aloud" tools
+read *every* reply at you. claude-can-speak leads with the opposite: a Claude
+Code **skill** that gives the model a deliberate "say this" capability, so Claude
+voices only what is worth hearing, a spoken "the build is done and tests passed"
+when you have stepped away, a heads-up that a deploy needs confirmation, a short
+shoutout you asked for, while everything else stays text-only. Selective, on
+purpose, model-controlled.
+
+If you *do* want the firehose, it is one command away: a Stop hook that speaks
+every finished reply, gated on the built-in `/voice` mode so one switch controls
+both directions (you talk to it, it talks back). But the deliberate skill is the
+point.
+
+- **Deliberate mode (the headline)** - the `speak` skill lets Claude choose what
+  to voice. Install with `claude-can-speak install-skill`.
+- **Firehose mode (optional)** - a Stop hook speaks every reply while `/voice` is
+  on. Install with `claude-can-speak install-hooks`.
 
 Speech is synthesised locally by [Kokoro](https://github.com/thewh1teagle/kokoro-onnx)
 (natural English, the default) or [Piper](https://github.com/OHF-Voice/piper1-gpl)
@@ -138,6 +144,20 @@ behalf. **By installing and using it you accept all risk.** You are responsible
 for complying with the licences of the bundled engines and the downloaded models
 (see [THIRD_PARTY.md](THIRD_PARTY.md)).
 
+## Related projects
+
+Speaking Claude Code's replies aloud is a well-trodden idea, and several tools do
+the firehose well: `claude-voice` (Kokoro plus karaoke word highlighting),
+`claude-code-tts` (OpenAI or Kokoro auto-speak), `claude-voice-mcp` and
+`soliloquy-tts` (MCP-based auto-speak). If all you want is "read every reply
+aloud", any of those is a fine choice and lighter than this one (no Docker).
+
+claude-can-speak is built around a different default: the deliberate `speak`
+skill, so Claude voices only what is worth hearing rather than everything. It
+also adds multilingual output (Piper for German, Turkish, and more), Docker
+isolation so the engines never touch your host Python, and gating on the built-in
+`/voice` switch. The firehose mode is included, but it is not the headline.
+
 ## Licence
 
 MIT - see [LICENSE](LICENSE). Author: Ramazan Yavuz. Part of the public,

package/bin/claude-can-speak

@@ -9,7 +9,7 @@
 # any damage or loss arising from its use. By using it you accept all risk.
 set -uo pipefail
 
-VERSION="0.1.0"
+VERSION="0.1.1"
 
 # Install layout: bundled scripts live in ../lib/claude-can-speak relative to
 # this CLI, whether installed via npm (into the global node_modules) or run from

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-can-speak",
-  "version": "0.1.0",
-  "description": "Speech-out for Claude Code: speak replies aloud (Stop-hook firehose) or let Claude voice deliberate notifications (skill). Local neural TTS via Kokoro/Piper in Docker. Gated on /voice mode.",
+  "version": "0.1.1",
+  "description": "Let Claude Code decide what to say out loud: a skill that voices deliberate notifications (not every reply), plus an optional speak-everything Stop hook. Local neural TTS via Kokoro/Piper in Docker, gated on /voice.",
   "keywords": [
     "claude",
     "claude-code",