@voxd/cli
v0.4.6
Published
Command-line tools for local transcription and text-to-speech with Vox.
Downloads
1,301
Readme
@voxd/cli
Transcribe files, generate speech, and manage Vox from the terminal. Installing this package adds the vox command.
Install
npm install -g @voxd/cliRequires Node 22+ on macOS.
First-time setup
Install Vox Companion, then connect the CLI to its local service:
vox install
vox doctorvox doctor should finish with ready: true.
Common tasks
# Transcribe a file
vox warmup start parakeet:v3
vox transcribe file --metrics --timestamps /tmp/sample.wav
# Generate speech
vox voices --model avspeech:system
vox speak --metrics "Hello from Vox"
# Inspect the runtime
vox daemon status
vox perf dashboard
vox logs daemon --tail 80Run vox help for the complete command list.
Install Minivox
Minivox is the small, single-purpose dictation app. Install it without adding another npm package:
npx -y @voxd/cli@latest install miniThe installer opens Minivox automatically. Look for the waveform in the menu bar. Put the cursor where you want text, press ⌥Space to start dictating, then press ⌥Space again to stop. The first use asks for microphone access, and the first dictation may download Parakeet. Minivox always copies the result; grant Accessibility access when prompted if you also want it pasted automatically.
The installer adds minivox under ~/.local/bin. Use minivox settings to change the shortcut or microphone. Use --quiet for errors-only output or --verbose to include Apple verification and disk-image details.
minivox
minivox settings
minivox quitUseful command groups
vox doctor— check that Vox is readyvox transcribe— transcribe files, benchmark, or use the microphonevox speakandvox voices— generate speechvox warmupandvox models— prepare speech modelsvox history,vox logs, andvox perf— inspect activity and timingvox daemon— start, stop, or check the local service
Choose the right package
- Terminal:
@voxd/cli - Bun or Node:
@voxd/sdk - Browser:
@voxd/client - macOS or iOS app: embed
VoxCoreandVoxEngine
