voice-edit¶

A voice-powered clipboard assistant that edits text based on spoken commands.

Usage¶

agent-cli voice-edit [OPTIONS]

Description¶

This command is designed for a hotkey-driven workflow to act on text you've already copied:

Copy a block of text to your clipboard (e.g., an email draft)
Press a hotkey to start the agent—it begins listening
Speak a command: "Make this more formal" or "Summarize the key points"
Press the hotkey again to stop recording
The agent transcribes your command, sends it with the clipboard text to the LLM
The result is copied back to your clipboard
Optionally speaks the result if --tts is enabled

Examples¶

# Run in foreground
agent-cli voice-edit --input-device-index 1

# Run in background (for hotkey integration)
agent-cli voice-edit --input-device-index 1 &

# With text-to-speech response
agent-cli voice-edit --tts

# Check status
agent-cli voice-edit --status

# Stop background process
agent-cli voice-edit --stop

Options¶

Provider Selection¶

Option	Description	Default
`--asr-provider`	ASR provider: `wyoming`, `openai`	`wyoming`
`--llm-provider`	LLM provider: `ollama`, `openai`, `gemini`	`ollama`
`--tts-provider`	TTS provider: `wyoming`, `openai`, `kokoro`	`wyoming`

Audio Input¶

Option	Description
`--input-device-index`	Index of audio input device
`--input-device-name`	Input device name keywords
`--list-devices`	List available devices

ASR (Wyoming, local)¶

Option	Description	Default
`--asr-wyoming-ip`	Wyoming ASR server IP	`localhost`
`--asr-wyoming-port`	Wyoming ASR server port	`10300`

ASR (OpenAI)¶

Option	Description	Default
`--asr-openai-model`	OpenAI ASR model	`whisper-1`

LLM (Ollama, local)¶

Option	Description	Default
`--llm-ollama-model`	Ollama model to use	`gemma3:4b`
`--llm-ollama-host`	Ollama server URL	`http://localhost:11434`

LLM (OpenAI)¶

Option	Description	Default
`--llm-openai-model`	OpenAI model to use	`gpt-5-mini`
`--openai-api-key`	OpenAI API key (or set `OPENAI_API_KEY`)	-
`--openai-base-url`	Custom OpenAI-compatible API URL (or set `OPENAI_BASE_URL`)	-

LLM (Gemini)¶

Option	Description	Default
`--llm-gemini-model`	Gemini model to use	`gemini-2.5-flash`
`--gemini-api-key`	Gemini API key (or set `GEMINI_API_KEY`)	-

TTS Options (General)¶

Option	Description	Default
`--tts` / `--no-tts`	Enable text-to-speech response	`false`
`--tts-speed`	Speech speed multiplier	`1.0`
`--output-device-index`	Index of audio output device	-
`--output-device-name`	Output device name keywords	-

TTS (Wyoming, local)¶

Option	Description	Default
`--tts-wyoming-ip`	Wyoming TTS server IP	`localhost`
`--tts-wyoming-port`	Wyoming TTS server port	`10200`
`--tts-wyoming-voice`	Voice name for Wyoming TTS	-
`--tts-wyoming-language`	Language for Wyoming TTS	-
`--tts-wyoming-speaker`	Speaker name for Wyoming TTS voice	-

TTS (OpenAI)¶

Option	Description	Default
`--tts-openai-model`	OpenAI TTS model	`tts-1`
`--tts-openai-voice`	OpenAI voice	`alloy`
`--tts-openai-base-url`	Custom OpenAI-compatible URL	-

TTS (Kokoro)¶

Option	Description	Default
`--tts-kokoro-model`	Kokoro model	`kokoro`
`--tts-kokoro-voice`	Kokoro voice	`af_sky`
`--tts-kokoro-host`	Kokoro API URL	`http://localhost:8880/v1`

Output Options¶

Option	Description	Default
`--clipboard` / `--no-clipboard`	Copy result to clipboard	`true`

Process Management¶

Option	Description
`--stop`	Stop running background process
`--status`	Check if process is running
`--toggle`	Toggle process on/off

General Options¶

Option	Description	Default
`--save-file PATH`	Save TTS response audio to WAV file	-
`--log-level`	Set logging level	`WARNING`
`--log-file PATH`	Path to a file to write logs to	-
`--quiet`, `-q`	Suppress console output	`false`
`--config PATH`	Path to a TOML configuration file	-
`--print-args`	Print resolved arguments including config values	`false`

Hotkey Integration¶

macOS (skhd)¶

# Toggle voice-edit with Cmd+Shift+V
cmd + shift + v : /path/to/agent-cli voice-edit --toggle --input-device-index 1

Linux (Hyprland)¶

bind = SUPER SHIFT, V, exec, agent-cli voice-edit --toggle --input-device-index 1

Example Commands¶

Once activated, you can give commands like:

"Make this more formal"
"Summarize the key points"
"Fix the grammar"
"Translate to Spanish"
"Make it shorter"
"Add bullet points"
"Rewrite for a technical audience"

Workflow Example¶

Copy an email draft:

hey can u help me with the project tmrw?

Press hotkey, speak: "Make this professional"
Press hotkey again to stop

Paste the result:

Hello,

Would you be available to assist me with the project tomorrow?

Best regards