voxtype-install

Guides installation, configuration, and launch of voxtype on-device voice dictation on macOS.

2.0k|131|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/pchalasani/claude-code-tools --skill voxtype-install
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voxtype-install
Source: https://github.com/pchalasani/claude-code-tools/tree/main/plugins/voxtype/skills/voxtype-install
Command: npx skills add https://github.com/pchalasani/claude-code-tools --skill voxtype-install

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up local speech-to-text dictation involves choosing an engine, granting macOS permissions, and tuning hotkeys and modes; this Skill walks an agent through installing, configuring, and launching voxtype so users can dictate into any app without cloud services.

Core Features & Use Cases

  • Guided Installation: Installs voxtype via uv tool install voxtype (or pipx), automatically selecting the Apple-GPU parakeet-mlx engine on Apple Silicon or the CPU parakeet engine elsewhere.
  • Configuration Assistance: Runs the interactive voxtype setup wizard or edits ~/.config/voxtype/config.toml directly to tune engine, activation mode, hotkey, wake word, and sounds.
  • Launch & First-Run Support: Starts the dictation daemon and explains required macOS Microphone, Accessibility, and Input Monitoring permissions plus the one-time model download.
  • Use Case: A developer wants to dictate prompts into a coding agent's terminal; the agent installs voxtype, sets a toggle hotkey, and confirms dictation types text at the cursor.

Quick Start

Ask the agent to install and set up voxtype voice dictation on this Mac so you can dictate text into your terminal with a hotkey.

Frequently Asked Questions about voxtype-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install voxtype for voice dictation on macOS?

Run `uv tool install voxtype`, which automatically picks the best speech engine for your machine. If you lack uv, install it first or use `pipx install voxtype`, then run `voxtype setup` to configure it.

How do I set up voice typing into a terminal or coding agent?

Install voxtype, run the interactive `voxtype setup` wizard in your own terminal, then launch `voxtype`. Press the hotkey (default Ctrl+;), speak, and press it again to type the transcription at the cursor.

Does voxtype work on Linux or Windows?

No, voxtype only works on macOS because it types transcribed text using macOS accessibility APIs. Users on Linux or Windows need a different dictation tool.

Why is voxtype not typing after the first launch?

macOS requires Microphone, Accessibility, and Input Monitoring permissions for the terminal app, and all three must be granted before restarting voxtype. The first launch also downloads the speech model, which can take time.

What speech engines does voxtype support?

voxtype supports `parakeet-mlx` using the Apple GPU, `parakeet` on CPU, and `moonshine`. The installer selects the best engine automatically, and you can change it via the `engine` key in config.toml.