Usage

Usage

Start AgentWhisper from your applications menu. A microphone icon appears in the system tray — that's the app. It runs quietly until you press the hotkey.

Dictating

Two recording modes, switchable anytime (tray menu → Recording Mode):

Mode	How it works
Hold to talk (default)	Hold F12, speak, release.
Press to toggle	Press F12 to start, press again to stop.

While recording:

• the tray icon turns red
• a translucent panel appears near the bottom of the screen with green bars moving to your voice — your confirmation that the microphone is live

When you stop, the tray shows Transcribing… briefly, then the text is typed into the window you were working in and placed in your clipboard as backup. A small notification shows a preview of what was heard.

Notes:

• While AgentWhisper runs, F12 is reserved exclusively — other programs won't react to it. Ctrl+F12 / Alt+F12 keep working normally.
• Very short taps (under ~0.3 s) are ignored as accidental.
• Recordings are capped at 60 s (configurable) so a stuck key can't record forever.

The tray menu (right-click)

Item	Effect
status line	What to do in the current mode / current activity
Enabled	Pause/resume dictation without quitting
Auto-Type into active window	On: text is typed for you. Off: clipboard only (paste with Ctrl+V)
Notifications	The "Typed & copied" confirmations on/off
Recording Mode	Hold-to-talk vs. press-to-toggle
Quit AgentWhisper	Stop the app (releases F12)

The command line (optional)

Everything the tray does, plus inspection:

agentwhisper status        # full health report: engine, hotkey, desktop tools
agentwhisper toggle        # enable/disable dictation
agentwhisper mode hold     # or: toggle
agentwhisper quit

agentwhisper status is the first thing to run whenever something seems off — every subsystem reports its state there.