voice

Other Community

Skill notes

Step 1 — Prerequisites

Run these checks. If either fails, tell the user what to install and stop: Needs Python 3.10+. If python is not found, try python3 (macOS/Linux) or py (Windows). If missing: "Install Python 3.10 or newer from python.org, then restart Claude." Needs the Claude CLI. If missing: "Install the Claude CLI first — https://claude.com/claude-code"

Step 2 — First-run setup (venv + auto-install deps)

Install into a plugin-local venv, not the user's system Python. This dodges PEP 668 on modern Debian/Ubuntu/Fedora (where pip install --user is refused), and keeps faster-whisper's heavy deps isolated so uninstall is just rm -rf .venv. First check whether the venv already exists and has the deps: If the venv doesn't exist, create it (tell the user "Setting up voice mode (one-time, ~200 MB)..."):

Step 3 — Ask the user for language, model, and hotkey

Use AskUserQuestion with these FOUR questions (send all four in one call for a single round-trip — four is the AskUserQuestion tool maximum): Question 1 — "What language will you be speaking?" English → code en French → fr

Step 4 — Launch

Build the arg list: If user picked a specific language, add --language <code> Always add --model <chosen_model> If user picked a non-default hotkey, add --hotkey "<chosen_hotkey>" If user picked the quiet/whispered option, add --whisper-mode

Step 5 — Confirm to the user

Tell them concisely: A terminal window is now open showing voice-mode logs. Default hotkey: F8 (or whatever they picked) — hold to talk, release to paste the transcript into the focused window. For the transcript to land in the Claude Desktop App, click into the chat input before releasing the hotkey. (Focus safety will block paste if the focused window title doesn't contain "Claude".) First launch downloads the chosen Whisper model (size depends on choice).

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Other
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
Python >=3.10
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

01
Step 1 — Prerequisites

Run these checks. If either fails, tell the user what to install and stop: Needs Python 3.10+. If `python` is not found, try `python3` (macOS/Linux) or `py` (Windows). If missing: "Install Python 3.10 or newer from python.org, then restart Claude." Needs the Claude CLI. If missing: "Install the Claude CLI first — https://claude.com/claude-code"

02
Step 2 — First-run setup (venv + auto-install deps)

Install into a plugin-local venv, not the user's system Python. This dodges PEP 668 on modern Debian/Ubuntu/Fedora (where `pip install --user` is refused), and keeps faster-whisper's heavy deps isolated so uninstall is just `rm -rf .venv`. First check whether the venv already exists and has the deps: If the venv doesn't exist, create it (tell the user "Setting up voice mode (one-time, ~200 MB)..."):

03
Step 3 — Ask the user for language, model, and hotkey

Use AskUserQuestion with these FOUR questions (send all four in one call for a single round-trip — four is the AskUserQuestion tool maximum): Question 1 — "What language will you be speaking?" English → code `en` French → `fr`

04
Step 4 — Launch

Build the arg list: If user picked a specific language, add `--language <code>` Always add `--model <chosen_model>` If user picked a non-default hotkey, add `--hotkey "<chosen_hotkey>"` If user picked the quiet/whispered option, add `--whisper-mode`

05
Step 5 — Confirm to the user

Tell them concisely: A terminal window is now open showing voice-mode logs. Default hotkey: F8 (or whatever they picked) — hold to talk, release to paste the transcript into the focused window. For the transcript to land in the Claude Desktop App, click into the chat input before releasing the hotkey. (Focus safety will block paste if the focused window title doesn't contain "Claude".) First launch downloads the chosen Whisper model (size depends on choice).

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.