--- title: "Voice for AI Agents: Local Dictation + CLI | Voicetypr" description: "Use Voicetypr as local-first prompt input or a scriptable transcription CLI. See verified commands, limits, source links, and fit for developer workflows." image: "https://voicetypr.com/voicetypr-og.png" canonical_url: "https://voicetypr.com/voice-for-ai-agents" md_url: "https://voicetypr.com/voice-for-ai-agents.md" last_updated: "2026-07-27" language: "en" --- [Voicetypr](https://voicetypr.com/)/Voice for AI agents # Voice input for AI agents **Verdict:** Voicetypr fits developers who want local-first prompt dictation across apps or machine-readable transcription from a CLI. It is not an agent runtime and it does not submit prompts or control tools for you. Offline by defaultMac + WindowsScriptable transcription CLIPay once [Start 3-day free trial](https://voicetypr.com/download)[See pricing](https://voicetypr.com/#pricing) Two documented modes ## Focused-field dictation or command-line transcription Mode 1 — focused field ### Dictate a prompt for review Voicetypr transcribes speech and inserts text into the field that has focus. Its public repository lists Cursor, Claude Code, and ChatGPT as examples. This is input automation, not an agent plugin, and this update did not retest those fields. Mode 2 — command line ### Return text or JSON to a script The public v2 source documents status, models, transcribe, and record commands. File and microphone transcription can return a structured artifact for a script to inspect before it decides what to do next. Developer workflows ## Where each mode fits Use focused-field insertion for interactive prompts. Use the CLI when a script needs an explicit transcription result it can inspect. ### Cursor or chat composer Dictate a longer prompt, inspect the inserted text, then submit it yourself. ### Claude Code or another terminal Use focused-field dictation for interactive input where normal text paste is accepted. ### Audio-file pipeline Call the transcribe command with an explicit file path and request JSON for downstream parsing. ### Microphone capture Use the record command's currently documented stop-on-silence mode, then consume plain text or JSON. ### Model inventory Query status or models before choosing whether a workflow can run with the installed local setup. ### Trusted-LAN host Route a CLI transcription to an opted-in Voicetypr network-sharing host when that boundary is acceptable. Transcription CLI ## Commands verified in the public source Install the command from Settings → Advanced, then check `voicetypr --help` on the installed version. Add `--json` when a script needs structured output. - ✓ Install the command from Voicetypr Settings → Advanced, then use voicetypr --help as the live command reference. - ✓ voicetypr status --json and voicetypr models --json expose setup and installed-model information. - ✓ voicetypr transcribe --file to transcribe an audio file, or voicetypr record --until-silence to capture and transcribe live. - ✓ Add --json for a structured result containing text, words, metadata, and local model or engine fields. - ✓ For an opted-in network-sharing host, --server is supported; prefer --password-stdin or VOICETYPR_REMOTE_PASSWORD over a command-line password. terminal `$ voicetypr transcribe --file note.wav --json { "text": "Refactor the auth middleware to use the new token store.", "words": [ /* structured word data */ ], "metadata": { /* transcription metadata */ }, "model": "", "engine": "" } $ voicetypr record --until-silence --json $ voicetypr transcribe --file clip.wav \ --model whisper --engine local \ --server 192.168.1.20:47842 --password-stdin --json` Know the boundary ## What “voice for agents” does not mean - ✓ Voicetypr is a speech-to-text input layer. It is not an AI agent runtime, orchestrator, or speech-response system. - ✓ Focused-field mode does not submit prompts, approve commands, read repository context, or call agent tools. - ✓ Local transcription stays on the device; optional cloud speech or AI formatting introduces the provider data flow you select. - ✓ The public source includes an opt-in network-sharing HTTP server, but we found no standalone stability contract for direct HTTP consumers. This guide treats the CLI as the documented automation surface. Last verified: July 27, 2026 ## Sources and review method This update used source inspection, not a hands-on release test. We reviewed the public CLI parser, launcher, network implementation, README, and release notes. We did not install a macOS or Windows build, execute the CLI, test microphone capture, or connect it to an agent framework. The product-level commands shown here are therefore source-verified; the APP verification gate remains open for environment compatibility and end-to-end automation. - [Voicetypr v2 release notes for CLI installation and JSON output](https://github.com/ideaplexa/voicetypr/blob/main/CHANGELOG.md) - [CLI command, flag, output, and remote-routing source](https://github.com/ideaplexa/voicetypr/blob/main/src-tauri/src/cli.rs) - [macOS and Windows CLI launcher source](https://github.com/ideaplexa/voicetypr/blob/main/src-tauri/src/commands/cli_tool.rs) - [Network-sharing HTTP route and authentication source](https://github.com/ideaplexa/voicetypr/blob/main/src-tauri/src/remote/http.rs) - [Public desktop repository and focused-field workflow description](https://github.com/ideaplexa/voicetypr) FAQ ## Voice for AI agents, answered ### Does Voicetypr connect to Cursor or Claude Code as a plugin? No. In interactive use, Voicetypr inserts transcribed text into the focused field. That makes it portable across apps, but it does not give Voicetypr repository context, agent state, or tool access. ### Can an AI agent or script call Voicetypr directly? A script can invoke the installed Voicetypr CLI. The source documents status, models, transcribe, and record commands, with --json available for machine-readable output. The calling script remains responsible for validation, routing, and any agent action that follows. ### Is the network-sharing HTTP server a public API contract? The public repository includes versioned HTTP routes used for network transcription, but this review found no separate public compatibility or stability document for direct consumers. Prefer the documented CLI unless you are prepared to track the source-level HTTP implementation. ### Does it run offline? Local Whisper or Parakeet transcription runs on the device after the selected model is downloaded. Optional cloud speech-to-text and optional AI formatting are different modes with different data flows. ### How do I get JSON output for my pipeline? Add --json to a CLI call. For example, voicetypr transcribe --file note.wav --json returns { text, words, metadata, model, engine }. You can also set --model and --engine per call, and use --server with an optional --password to route to a running instance. ### Does Voicetypr run or control the AI agent? No. It supplies transcribed text. It does not submit the prompt, choose tools, approve terminal actions, execute an agent loop, or speak the agent's response. ### Was the CLI hands-on tested for this guide? Not for this July 2026 update. We reviewed the public Rust source and release notes, but did not install a release build or execute the commands. Run voicetypr --help and test non-sensitive audio in your own environment before adding it to automation. Related guides ## More ways to put voice in your dev workflow Narrow to Cursor, inspect the trusted-LAN boundary, or step back to the broader developer dictation workflow. [single-tool focus Voice input for Cursor For developers evaluating focused-field dictation for Cursor prompts, PR notes, and context. See the Cursor page →](https://voicetypr.com/voice-input-for-cursor) [broader workflow Voice typing in every app The general pay-once dictation story for builders deciding whether voice belongs in their daily setup. See the general guide →](https://voicetypr.com/voice-typing) [trusted-LAN option Network transcription Review the network boundary, opt-in sharing behavior, authentication, and source-backed limits before using --server. See network transcription →](https://voicetypr.com/network-transcription) [broader workflow Dictation for developers Prompts, issues, PR notes, and documentation beyond the automation surface. See the developer use case →](https://voicetypr.com/use-cases/developers) ## Test the dictation layer before you automate it Use the 3-day free trial and voicetypr --help to verify your installed release, models, permissions, and output contract. [Start free trial](https://voicetypr.com/download)[Buy lifetime license](https://voicetypr.com/#pricing)