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

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

@@ -3,6 +3,15 @@
 All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## 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.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vocalize-cli
-Version: 0.7.0
+Version: 0.7.1
 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
@@ -263,6 +263,10 @@ Two Services let you use vocalize from any app without a terminal:
   Cancel (that's the `--ask-dialog` flag at work).
 - **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:
 

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

@@ -229,6 +229,10 @@ Two Services let you use vocalize from any app without a terminal:
   Cancel (that's the `--ask-dialog` flag at work).
 - **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:
 

{vocalize_cli-0.7.0 → vocalize_cli-0.7.1}/hooks/install_quick_action.py

@@ -17,7 +17,11 @@ 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")
+BUNDLE_NAMES = (
+    "Speak with Vocalize.workflow",
+    "Stop Vocalize.workflow",
+    "Speak Latest Plan.workflow",
+)
 PLACEHOLDER = "__VOCALIZE_BIN__"
 PBS = "/System/Library/CoreServices/pbs"
 

vocalize_cli-0.7.1/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.7.1/hooks/quick_actions/Speak Latest Plan.workflow/Contents/Resources/document.wflow

@@ -0,0 +1,209 @@
+<?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
+exec "$BIN" speak-file "$PLAN" --play --ask-dialog</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.7.1}/tests/test_install_quick_action.py

@@ -156,3 +156,16 @@ def test_checked_in_stop_bundle_takes_no_stdin():
     # inputMethod 1 = as-arguments: a no-input service must not wait on stdin.
     assert params["inputMethod"] == 1
     assert " stop" in params["COMMAND_STRING"]
+
+
+def test_checked_in_plan_bundle_speaks_newest_plan_on_demand():
+    doc = _real_wflow("Speak Latest Plan.workflow")
+    params = doc["actions"][0]["action"]["ActionParameters"]
+    script = params["COMMAND_STRING"]
+    # No-input service (inputMethod 1), reads the newest plan file, asks
+    # via dialog when over the cap, and quotes the resolved path.
+    assert params["inputMethod"] == 1
+    assert '.claude/plans"/*.md' in script
+    assert "--ask-dialog" in script
+    assert 'speak-file "$PLAN"' in script
+    assert install_quick_action.PLACEHOLDER in script

{vocalize_cli-0.7.0 → vocalize_cli-0.7.1}/vocalize/__init__.py

@@ -7,4 +7,4 @@ formatting into something that actually sounds good spoken aloud
 which is close to useless).
 """
 
-__version__ = "0.7.0"
+__version__ = "0.7.1"