murmur-cli 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Tarun Yadav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# murmur-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Command line and MCP access to [Murmur](https://www.murmurtts.com/), an offline text-to-speech and voice cloning app for Mac. Speech is generated on your own computer; your text is never uploaded.
+
+This package is a small launcher. It finds the signed CLI that ships inside Murmur.app and runs it, so you can call `murmur` from any project, npm script or AI agent.
+
+## Requirements
+
+- macOS 15 or later (Apple Silicon or Intel)
+- The Murmur app, free to download: https://www.murmurtts.com/download/latest
+- Automation turned on once in Murmur > Settings > Automation
+
+## Install
+
+```sh
+npm install -g murmur-cli
+murmur status
+```
+
+Or run it without installing:
+
+```sh
+npx murmur-cli status
+```
+
+## Generate speech
+
+```sh
+murmur generate --text "Welcome back. Today we're building a local voice workflow." \
+  --voice af_bella --speed 0.95 --output audio/intro.wav
+
+murmur generate --input scripts/chapter-01.txt --model kokoro --output audio/chapter-01.m4a
+```
+
+Other commands:
+
+```sh
+murmur models [--json]
+murmur models install MODEL_ID
+murmur voices [--model ID] [--json]
+murmur batch --manifest scenes.json
+murmur jobs get JOB_ID
+```
+
+Run `murmur --help` for every option.
+
+## Use with AI agents (MCP)
+
+Murmur includes an MCP server, so Claude Code, Codex, Cursor and other MCP clients can generate voiceovers on your Mac.
+
+```sh
+claude mcp add --transport stdio --scope user murmur -- npx -y murmur-cli mcp serve
+```
+
+```json
+{
+  "mcpServers": {
+    "murmur": { "command": "npx", "args": ["-y", "murmur-cli", "mcp", "serve"] }
+  }
+}
+```
+
+## Custom app location
+
+If Murmur.app is not in `/Applications` or `~/Applications`, point to the helper:
+
+```sh
+export MURMUR_HELPER="/path/to/Murmur.app/Contents/Helpers/murmur"
+```
+
+## Docs
+
+Full CLI and MCP guide: https://www.murmurtts.com/docs/automation
+
+The launcher in this package is MIT licensed. The Murmur app has its own license, with a free plan and a one-time Pro upgrade.

package/bin/murmur.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+"use strict";
+// Thin launcher for the signed Murmur CLI that ships inside Murmur.app.
+// All speech generation happens in the app on this Mac; this script only finds the helper and runs it.
+const { spawn } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { homedir } = require("node:os");
+const { join } = require("node:path");
+
+const HELPER = "Murmur.app/Contents/Helpers/murmur";
+const candidates = [
+  process.env.MURMUR_HELPER,
+  join("/Applications", HELPER),
+  join(homedir(), "Applications", HELPER),
+].filter(Boolean);
+
+if (process.platform !== "darwin") {
+  console.error("murmur-cli needs macOS. The Murmur CLI ships with the Mac app: https://www.murmurtts.com/");
+  process.exit(1);
+}
+
+const helper = candidates.find((p) => existsSync(p));
+if (!helper) {
+  console.error(
+    [
+      "Murmur.app was not found in /Applications or ~/Applications.",
+      "",
+      "murmur-cli runs the CLI that ships inside the free Murmur app. Install the app first:",
+      "  Download: https://www.murmurtts.com/download/latest",
+      "  Homebrew: brew install --cask murmur (once the cask is accepted)",
+      "",
+      "Then enable access once in Murmur > Settings > Automation.",
+      "If the app lives somewhere else, set MURMUR_HELPER to the full path of Contents/Helpers/murmur.",
+    ].join("\n"),
+  );
+  process.exit(1);
+}
+
+const child = spawn(helper, process.argv.slice(2), { stdio: "inherit" });
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(sig, () => child.kill(sig));
+child.on("error", (err) => {
+  console.error(`Could not start ${helper}: ${err.message}`);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 1);
+});

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "murmur-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Command line and MCP access to Murmur, the offline text-to-speech app for Mac. Generate speech and clone voices locally.",
+  "bin": { "murmur": "bin/murmur.js", "murmur-cli": "bin/murmur.js" },
+  "files": ["bin", "README.md"],
+  "os": ["darwin"],
+  "engines": { "node": ">=18" },
+  "keywords": ["text-to-speech", "tts", "voice-cloning", "offline", "local", "mac", "macos", "mcp", "kokoro", "qwen3-tts", "speech-synthesis", "cli"],
+  "homepage": "https://www.murmurtts.com/docs/automation",
+  "author": "Murmur <hello@murmurtts.com>",
+  "license": "MIT"
+}