Home/Integrations/Terminal & iTerm2
Command Line•Developer Workflow

Dictate Git commits and commands into your Mac terminal

Writing detailed Git commit messages and complex shell commands in your terminal is faster by voice. Speak naturally, and Valcy types directly into your command line prompt.

The Challenge

Why manual typing in Terminal & iTerm2 slows you down

Typing long, detailed Git commit messages inside Vim, Nano, or git commit -m '...' is slow. Most developers end up writing lazy one-line commit summaries just to move on quickly, which hurts code review clarity.

How Valcy Helps

Speak naturally at your normal conversational pace

Instead of settling for a three-word summary, you can speak three clear sentences in seconds. Valcy formats your message, removes filler words, and types it directly into your shell prompt or commit editor without losing terminal focus.

Real-World Examples

Compare spoken input to final text in Terminal & iTerm2

Valcy automatically filters out verbal hesitations, corrects punctuation, and formats sentences clearly.

Descriptive Git Commit MessageWriting a commit message for an authentication bug fix
Spoken Voice Input

“git commit dash m fix race condition when renewing oauth refresh token before initial session expiration”

Inserted TextInserted at cursor
git commit -m "Fix race condition when renewing OAuth refresh token before initial session expiration"
Docker Container Launch CommandDictating a local development container command
Spoken Voice Input

“docker run dash d dash p three thousand colon three thousand dash dash name valcy dev redis latest”

Inserted TextInserted at cursor
docker run -d -p 3000:3000 --name valcy-dev redis:latest
Feature Branch CreationCreating a new descriptive Git branch
Spoken Voice Input

“git checkout dash b feature slash user onboarding audio pipeline improvements”

Inserted TextInserted at cursor
git checkout -b feature/user-onboarding-audio-pipeline-improvements

Key Advantages for Terminal & iTerm2 Users

01

Works Across All Mac Terminal Emulators

Fully compatible with macOS Terminal, iTerm2, Warp, Alacritty, Kitty, and embedded terminals in VS Code and Cursor.

02

Build Better Git Histories Without Effort

Stop writing vague commit messages like 'fix bug'. Speak a detailed explanation of what changed and why in just five seconds.

03

Never Steals Window Focus

Valcy's non-activating HUD ensures your active terminal session never loses keyboard focus or interrupts running command processes.

Setup Guide

Quick Setup (Under 1 Minute)

Valcy runs as a native macOS utility and requires no custom Terminal & iTerm2 extensions.

01

Open Terminal or iTerm2

Make sure your cursor is active in your command line prompt or editor.

02

Press Your Valcy Shortcut

Tap your preferred hotkey.

03

Speak Your Command or Commit

Dictate naturally. Valcy formats and types the text directly into your shell prompt.

Performance & Privacy
Direct macOS input injection compatible with Zsh, Bash, Fish, and shell emulators
Local Whisper Metal GPU transcription runs completely on Apple Silicon
Inserts text without pressing Enter so you can review before executing
Completely private and offline for secure corporate development environments
Frequently Asked Questions

Common Questions About Using Valcy with Terminal & iTerm2

Will Valcy automatically run the command in my terminal?

No. Valcy inserts the text into your terminal prompt without pressing Enter. You always get to review the command before pressing Enter yourself.

Does Valcy work in iTerm2, Warp, and Alacritty?

Yes. Valcy uses native macOS accessibility APIs that work universally across Apple Terminal, iTerm2, Warp, Alacritty, Kitty, and tmux.

Can I dictate inside terminal text editors like Vim or Nano?

Yes. As long as Vim, Nano, or Micro is in insert or edit mode, Valcy types directly into your document just like a physical keyboard.

Are my shell commands, server names, and tokens private?

Yes. In Local Mode, transcription runs 100% on your Mac's Apple Silicon chip. None of your command history, environment variables, or voice audio is sent to the internet.

Explore Other Supported Apps

Experience Faster Dictation in Terminal & iTerm2

Download Valcy for macOS and test private, local-first voice typing across your daily workflow.