vocalize-cli 0.7.0__tar.gz → 0.8.0__tar.gz

{vocalize_cli-0.7.0 → vocalize_cli-0.8.0}/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## 0.8.0 - 2026-08-31
+
+### Added
+
+- The "Speak with Vocalize" and "Speak Latest Plan" Quick Actions now show
+  a picker when input is over the cap and overflow is `ask`: speak all,
+  three summary depths — light (~25s), medium (~1 min), detailed (~2.5 min)
+  — or truncate. Summaries are generated by piping the text through
+  `claude -p --model haiku` (tools denied); each is spoken with a hard
+  ceiling so an over-long summary can't reintroduce a long read. New
+  `hooks/speak_options.py` is the picker/summarizer front-end.
+- `hooks/install_quick_action.py` now also resolves and bakes a `claude`
+  binary path (plus the PATH additions it needs under a bare Services
+  environment) and the helper's location. `claude` is optional — without
+  it, the picker just omits the three summary depths. Re-run the installer
+  to pick up a newly installed `claude`. Picking a summary has a few
+  seconds of silent cold-start before audio begins.
+
+## 0.7.1 - 2026-08-31
+
+### Added
+
+- "Speak Latest Plan" Quick Action — a no-input Service that speaks the
+  newest plan under `~/.claude/plans/` on demand (dialog-asks when over
+  the cap). For hearing a Claude Code plan proposal before accepting it;
+  installed by the same `hooks/install_quick_action.py`.
+
 ## 0.7.0 - 2026-08-31
 
 ### Added

{vocalize_cli-0.7.0 → vocalize_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vocalize-cli
-Version: 0.7.0
+Version: 0.8.0
 Summary: A CLI that turns text, markdown, or piped stdin into speech via the ElevenLabs API, with markdown-table-aware preprocessing.
 Project-URL: Homepage, https://github.com/matthager12-collab/vocalize
 Project-URL: Repository, https://github.com/matthager12-collab/vocalize
@@ -259,10 +259,18 @@ Two Services let you use vocalize from any app without a terminal:
 - **Speak with Vocalize** — highlight text anywhere, right-click →
   Services → Speak with Vocalize. It stops whatever was already playing
   and reads the selection. If the selection is over your cap and your
-  overflow mode is `ask`, a native dialog asks Truncate / Speak all /
-  Cancel (that's the `--ask-dialog` flag at work).
+  overflow mode is `ask`, a picker offers **Speak all**, three summary
+  depths (**light** ~25s, **medium** ~1 min, **detailed** ~2.5 min), or
+  **Truncate**. Summaries are produced by `claude -p --model haiku` (with
+  tools denied) — picking one has a few seconds of silent cold-start
+  before audio begins. If no `claude` binary was found when you ran the
+  installer, the picker simply omits the three summary depths.
 - **Stop Vocalize** — appears in every app's application menu → Services;
   silences playback from anywhere.
+- **Speak Latest Plan** — reads the newest Claude Code plan file
+  (`~/.claude/plans/`) aloud on demand. Made for the plan-approval moment:
+  the proposal card is up, you press your shortcut, hear the plan, then
+  accept or reject. Nothing reads unless you trigger it.
 
 Install both:
 
@@ -271,10 +279,12 @@ python3 hooks/install_quick_action.py
 ```
 
 This copies the bundles from `hooks/quick_actions/` into
-`~/Library/Services/` with this machine's absolute `vocalize` path baked
-in, then refreshes the Services registry. To trigger them from the
-keyboard, assign shortcuts under System Settings → Keyboard → Keyboard
-Shortcuts → Services → Text.
+`~/Library/Services/` with this machine's absolute `vocalize`, `claude`,
+and helper paths baked in, then refreshes the Services registry. Run it
+from a normal terminal — its PATH is what gets captured. To trigger the
+actions from the keyboard, assign shortcuts under System Settings →
+Keyboard → Keyboard Shortcuts → Services (Stop Vocalize is worth a
+shortcut of its own so you can silence a read from anywhere).
 
 Some Electron apps (Claude Code desktop among them) don't expose the
 Services menu for text selected in their own window. There, copy the

{vocalize_cli-0.7.0 → vocalize_cli-0.8.0}/README.md

@@ -225,10 +225,18 @@ Two Services let you use vocalize from any app without a terminal:
 - **Speak with Vocalize** — highlight text anywhere, right-click →
   Services → Speak with Vocalize. It stops whatever was already playing
   and reads the selection. If the selection is over your cap and your
-  overflow mode is `ask`, a native dialog asks Truncate / Speak all /
-  Cancel (that's the `--ask-dialog` flag at work).
+  overflow mode is `ask`, a picker offers **Speak all**, three summary
+  depths (**light** ~25s, **medium** ~1 min, **detailed** ~2.5 min), or
+  **Truncate**. Summaries are produced by `claude -p --model haiku` (with
+  tools denied) — picking one has a few seconds of silent cold-start
+  before audio begins. If no `claude` binary was found when you ran the
+  installer, the picker simply omits the three summary depths.
 - **Stop Vocalize** — appears in every app's application menu → Services;
   silences playback from anywhere.
+- **Speak Latest Plan** — reads the newest Claude Code plan file
+  (`~/.claude/plans/`) aloud on demand. Made for the plan-approval moment:
+  the proposal card is up, you press your shortcut, hear the plan, then
+  accept or reject. Nothing reads unless you trigger it.
 
 Install both:
 
@@ -237,10 +245,12 @@ python3 hooks/install_quick_action.py
 ```
 
 This copies the bundles from `hooks/quick_actions/` into
-`~/Library/Services/` with this machine's absolute `vocalize` path baked
-in, then refreshes the Services registry. To trigger them from the
-keyboard, assign shortcuts under System Settings → Keyboard → Keyboard
-Shortcuts → Services → Text.
+`~/Library/Services/` with this machine's absolute `vocalize`, `claude`,
+and helper paths baked in, then refreshes the Services registry. Run it
+from a normal terminal — its PATH is what gets captured. To trigger the
+actions from the keyboard, assign shortcuts under System Settings →
+Keyboard → Keyboard Shortcuts → Services (Stop Vocalize is worth a
+shortcut of its own so you can silence a read from anywhere).
 
 Some Electron apps (Claude Code desktop among them) don't expose the
 Services menu for text selected in their own window. There, copy the

vocalize_cli-0.8.0/hooks/install_quick_action.py

@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""Copy the vocalize Quick Actions into ~/Library/Services/.
+
+Unlike install_hook.py there is no shared settings file to merge into —
+each Service is a self-contained bundle, so "install" is: copy the bundle
+with this machine's absolute vocalize path baked in. Re-running simply
+overwrites the same two bundles.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from xml.sax.saxutils import escape as xml_escape
+
+TEMPLATES_DIR = Path(__file__).resolve().parent / "quick_actions"
+SERVICES_DIR = Path.home() / "Library" / "Services"
+BUNDLE_NAMES = (
+    "Speak with Vocalize.workflow",
+    "Stop Vocalize.workflow",
+    "Speak Latest Plan.workflow",
+)
+PLACEHOLDER = "__VOCALIZE_BIN__"
+CLAUDE_PLACEHOLDER = "__CLAUDE_BIN__"
+CLAUDE_EXTRA_PATH_PLACEHOLDER = "__CLAUDE_EXTRA_PATH__"
+HELPER_PLACEHOLDER = "__HELPER__"
+PBS = "/System/Library/CoreServices/pbs"
+
+# Baked values land inside "..." in the Quick Action's zsh script. These
+# characters could escape those quotes, so refuse rather than try to quote.
+_UNSAFE_PATH_CHARS = set('"\\`$')
+
+
+def _resolve_vocalize_bin() -> Path:
+    repo_venv = Path(__file__).resolve().parent.parent / ".venv" / "bin" / "vocalize"
+    if repo_venv.is_file():
+        return repo_venv
+    on_path = shutil.which("vocalize")
+    if on_path:
+        return Path(on_path).resolve()
+    print(
+        "Could not find a vocalize binary (checked .venv/bin/vocalize next to "
+        "this repo, then PATH). Install vocalize first.",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+
+def _resolve_helper() -> Path:
+    helper = Path(__file__).resolve().parent / "speak_options.py"
+    if not helper.is_file():
+        print(f"Could not find the picker helper at {helper}.", file=sys.stderr)
+        sys.exit(1)
+    return helper
+
+
+def _resolve_claude() -> tuple[str, str]:
+    """Return (claude_path, extra_PATH). Empty strings when claude is absent.
+
+    claude.exe may need `node` resolved via PATH even when invoked by its
+    absolute path, and a bare Services environment has neither on PATH, so
+    bake claude's and node's directories for the helper to prepend.
+    """
+    found = shutil.which("claude")
+    if not found:
+        return "", ""
+    claude_path = Path(found).resolve()
+    dirs = [str(claude_path.parent)]
+    node = shutil.which("node")
+    if node:
+        node_dir = str(Path(node).resolve().parent)
+        if node_dir not in dirs:
+            dirs.append(node_dir)
+    return str(claude_path), os.pathsep.join(dirs)
+
+
+def _install_one(name: str, substitutions: dict) -> None:
+    src = TEMPLATES_DIR / name
+    dest = SERVICES_DIR / name
+    if dest.exists():
+        shutil.rmtree(dest)
+    shutil.copytree(src, dest)
+
+    wflow = dest / "Contents" / "Resources" / "document.wflow"
+    text = wflow.read_text(encoding="utf-8")
+    for placeholder, value in substitutions.items():
+        text = text.replace(placeholder, xml_escape(value))
+    wflow.write_text(text, encoding="utf-8")
+
+
+def main() -> int:
+    bin_path = str(_resolve_vocalize_bin())
+    helper_path = str(_resolve_helper())
+    claude_path, claude_extra_path = _resolve_claude()
+
+    substitutions = {
+        PLACEHOLDER: bin_path,
+        HELPER_PLACEHOLDER: helper_path,
+        CLAUDE_PLACEHOLDER: claude_path,
+        CLAUDE_EXTRA_PATH_PLACEHOLDER: claude_extra_path,
+    }
+    for value in substitutions.values():
+        if _UNSAFE_PATH_CHARS & set(value):
+            print(
+                f"Refusing to install: a resolved path contains characters that "
+                f"would break the Quick Action script: {value!r}",
+                file=sys.stderr,
+            )
+            return 1
+
+    SERVICES_DIR.mkdir(parents=True, exist_ok=True)
+    for name in BUNDLE_NAMES:
+        _install_one(name, substitutions)
+        print(f"Installed {name} -> {SERVICES_DIR / name}")
+
+    # Nudge the Services registry so the new entries appear without a logout.
+    subprocess.run([PBS, "-update"], check=False)
+
+    print(f"\nUsing vocalize at: {bin_path}")
+    if claude_path:
+        print(f"Summaries via claude at: {claude_path}")
+    else:
+        print("claude not found; Quick Actions will offer speak-all / truncate only.")
+    print('Highlight text in any app, then right-click -> Services -> "Speak with Vocalize".')
+    print("Keyboard shortcuts: System Settings -> Keyboard -> Keyboard Shortcuts -> Services.")
+    print("If the actions don't appear, re-open the Services submenu once, or log out and in.")
+    print("Run this installer from a normal terminal (its PATH is what gets baked in).")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

vocalize_cli-0.8.0/hooks/quick_actions/Speak Latest Plan.workflow/Contents/Info.plist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSServices</key>
+	<array>
+		<dict>
+			<key>NSMenuItem</key>
+			<dict>
+				<key>default</key>
+				<string>Speak Latest Plan</string>
+			</dict>
+			<key>NSMessage</key>
+			<string>runWorkflowAsService</string>
+		</dict>
+	</array>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en_US</string>
+	<key>CFBundleIdentifier</key>
+	<string>cards.arda.vocalize.speakplan</string>
+	<key>CFBundleName</key>
+	<string>Speak Latest Plan</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+</dict>
+</plist>

vocalize_cli-0.8.0/hooks/quick_actions/Speak Latest Plan.workflow/Contents/Resources/document.wflow

@@ -0,0 +1,212 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AMApplicationBuild</key>
+	<string>346</string>
+	<key>AMApplicationVersion</key>
+	<string>2.3</string>
+	<key>AMDocumentVersion</key>
+	<string>2</string>
+	<key>actions</key>
+	<array>
+		<dict>
+			<key>action</key>
+			<dict>
+				<key>AMAccepts</key>
+				<dict>
+					<key>Container</key>
+					<string>List</string>
+					<key>Optional</key>
+					<true/>
+					<key>Types</key>
+					<array>
+						<string>com.apple.cocoa.string</string>
+					</array>
+				</dict>
+				<key>AMActionVersion</key>
+				<string>2.0.3</string>
+				<key>AMApplication</key>
+				<array>
+					<string>Automator</string>
+				</array>
+				<key>AMParameterProperties</key>
+				<dict>
+					<key>COMMAND_STRING</key>
+					<dict/>
+					<key>CheckedForUserDefaultShell</key>
+					<dict/>
+					<key>inputMethod</key>
+					<dict/>
+					<key>shell</key>
+					<dict/>
+					<key>source</key>
+					<dict/>
+				</dict>
+				<key>AMProvides</key>
+				<dict>
+					<key>Container</key>
+					<string>List</string>
+					<key>Types</key>
+					<array>
+						<string>com.apple.cocoa.string</string>
+					</array>
+				</dict>
+				<key>ActionBundlePath</key>
+				<string>/System/Library/Automator/Run Shell Script.action</string>
+				<key>ActionName</key>
+				<string>Run Shell Script</string>
+				<key>ActionParameters</key>
+				<dict>
+					<key>COMMAND_STRING</key>
+					<string># No input: speak the newest Claude Code plan file on demand.
+BIN="__VOCALIZE_BIN__"
+if [[ ! -x "$BIN" ]]; then
+  /usr/bin/osascript -e 'display notification "vocalize not found — re-run hooks/install_quick_action.py" with title "Vocalize"'
+  exit 1
+fi
+PLAN=$(ls -t "$HOME/.claude/plans"/*.md 2&gt;/dev/null | head -1)
+if [[ -z "$PLAN" ]]; then
+  /usr/bin/osascript -e 'display notification "No plan files found in ~/.claude/plans." with title "Vocalize"'
+  exit 0
+fi
+"$BIN" stop &gt;/dev/null 2&gt;&amp;1
+export VOCALIZE_BIN="$BIN"
+export CLAUDE_BIN="__CLAUDE_BIN__"
+export CLAUDE_EXTRA_PATH="__CLAUDE_EXTRA_PATH__"
+exec /usr/bin/python3 "__HELPER__" &lt; "$PLAN"</string>
+					<key>CheckedForUserDefaultShell</key>
+					<false/>
+					<key>inputMethod</key>
+					<integer>1</integer>
+					<key>shell</key>
+					<string>/bin/zsh</string>
+					<key>source</key>
+					<string></string>
+				</dict>
+				<key>BundleIdentifier</key>
+				<string>com.apple.RunShellScript</string>
+				<key>CFBundleVersion</key>
+				<string>2.0.3</string>
+				<key>CanShowSelectedItemsWhenRun</key>
+				<false/>
+				<key>CanShowWhenRun</key>
+				<true/>
+				<key>Category</key>
+				<array>
+					<string>AMCategoryUtilities</string>
+				</array>
+				<key>Class Name</key>
+				<string>RunShellScriptAction</string>
+				<key>InputUUID</key>
+				<string>2C7F9E10-55D2-4B31-9A6E-8E0D4C71F301</string>
+				<key>Keywords</key>
+				<array>
+					<string>Shell</string>
+					<string>Script</string>
+					<string>Command</string>
+					<string>Run</string>
+					<string>Unix</string>
+				</array>
+				<key>OutputUUID</key>
+				<string>2C7F9E10-55D2-4B31-9A6E-8E0D4C71F302</string>
+				<key>UUID</key>
+				<string>2C7F9E10-55D2-4B31-9A6E-8E0D4C71F303</string>
+				<key>UnlocalizedApplications</key>
+				<array>
+					<string>Automator</string>
+				</array>
+				<key>arguments</key>
+				<dict>
+					<key>0</key>
+					<dict>
+						<key>default value</key>
+						<integer>0</integer>
+						<key>name</key>
+						<string>inputMethod</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>0</string>
+					</dict>
+					<key>1</key>
+					<dict>
+						<key>default value</key>
+						<string></string>
+						<key>name</key>
+						<string>source</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>1</string>
+					</dict>
+					<key>2</key>
+					<dict>
+						<key>default value</key>
+						<false/>
+						<key>name</key>
+						<string>CheckedForUserDefaultShell</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>2</string>
+					</dict>
+					<key>3</key>
+					<dict>
+						<key>default value</key>
+						<string></string>
+						<key>name</key>
+						<string>COMMAND_STRING</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>3</string>
+					</dict>
+					<key>4</key>
+					<dict>
+						<key>default value</key>
+						<string>/bin/sh</string>
+						<key>name</key>
+						<string>shell</string>
+						<key>required</key>
+						<string>0</string>
+						<key>type</key>
+						<string>0</string>
+						<key>uuid</key>
+						<string>4</string>
+					</dict>
+				</dict>
+				<key>isViewVisible</key>
+				<true/>
+			</dict>
+			<key>isViewVisible</key>
+			<true/>
+		</dict>
+	</array>
+	<key>connectors</key>
+	<dict/>
+	<key>workflowMetaData</key>
+	<dict>
+		<key>serviceApplicationBundleID</key>
+		<string></string>
+		<key>serviceApplicationPath</key>
+		<string></string>
+		<key>serviceInputTypeIdentifier</key>
+		<string>com.apple.Automator.nothing</string>
+		<key>serviceOutputTypeIdentifier</key>
+		<string>com.apple.Automator.nothing</string>
+		<key>serviceProcessesInput</key>
+		<integer>0</integer>
+		<key>workflowTypeIdentifier</key>
+		<string>com.apple.Automator.servicesMenu</string>
+	</dict>
+</dict>
+</plist>

{vocalize_cli-0.7.0 → vocalize_cli-0.8.0}/hooks/quick_actions/Speak with Vocalize.workflow/Contents/Resources/document.wflow

@@ -59,15 +59,18 @@
 				<key>ActionParameters</key>
 				<dict>
 					<key>COMMAND_STRING</key>
-					<string># Selected text arrives on stdin. The only interpolated value is the
-# vocalize path, baked in by hooks/install_quick_action.py.
+					<string># Selected text arrives on stdin. Interpolated values (vocalize/claude
+# paths, helper location) are baked in by hooks/install_quick_action.py.
 BIN="__VOCALIZE_BIN__"
 if [[ ! -x "$BIN" ]]; then
   /usr/bin/osascript -e 'display notification "vocalize not found — re-run hooks/install_quick_action.py" with title "Vocalize"'
   exit 1
 fi
 "$BIN" stop &gt;/dev/null 2&gt;&amp;1
-exec "$BIN" speak-file - --play --ask-dialog</string>
+export VOCALIZE_BIN="$BIN"
+export CLAUDE_BIN="__CLAUDE_BIN__"
+export CLAUDE_EXTRA_PATH="__CLAUDE_EXTRA_PATH__"
+exec /usr/bin/python3 "__HELPER__"</string>
 					<key>CheckedForUserDefaultShell</key>
 					<false/>
 					<key>inputMethod</key>