Vocoding
Vocoding Docs
Settings

Automation & Profiles

Auto-copy, auto-paste, multi-task queue, Smart Bubble, and optimization profile management.

The Automation, Agents, and Profiles tabs control how Vocoding handles output delivery, parallel processing, and prompt optimization behavior.


Auto-Actions

SettingDescriptionDefault
Auto-copy to clipboardAutomatically copy resultsON
Auto-paste at cursorPaste result at active cursor positionOFF
Audio cuesSound feedback for recording start/stop/completeOFF

Note: Auto-paste requires accessibility permissions and may not work in all applications.


Multi-Task Queue

Process multiple voice inputs in parallel.

SettingDescriptionDefault
Max Active TasksMaximum parallel tasks (2-10)2
Max Local GPU TasksMaximum Ollama local tasks (1-4)1
Visible Stacked PillsPills shown in multi-task UI (1-5)1
Task NotificationsShow notifications for task eventsON
Notify on SuccessNotification when task completesON
Notify on ErrorsNotification when task failsON
Ollama Cloud OverridesCustom parameters for cloud tasks(empty)
Ollama Local OverridesCustom parameters for local tasks(empty)

Smart Bubble

The Smart Bubble is a floating pill that appears when long-running tasks transition from the main window.

SettingDescriptionDefault
Transition ThresholdSeconds before task moves to bubble (3-30s)8s
Pill CornerScreen corner for the bubbletop-right
Auto-Dismiss TimeoutSeconds before bubble auto-hides (10-300s, or "Never")60s
Paste BehaviorWhen to auto-paste: always / smart / neversmart (macOS)
Tray Recent ResultsNumber of recent results in tray menu (3-20)5

Corner Options

PositionDescription
top-rightTop-right corner of screen (default)
top-leftTop-left corner of screen
bottom-rightBottom-right corner of screen
bottom-leftBottom-left corner of screen

Paste Behavior Options

OptionBehavior
AlwaysAuto-paste result at cursor immediately
SmartAuto-paste only if the cursor is in a text field (macOS default)
NeverOnly copy to clipboard, never auto-paste

Agents Tab (in Settings)

This tab provides the same agent management as the dedicated Agents view (Cmd + 2).

FeatureDescription
Global toggleEnable/disable all agents
Category togglesEnable/disable entire categories with count badges
Built-in agents gridBrowse and manage system agents
Custom agents gridManage your custom agents (Edit, Export, Delete)
Import / New AgentImport from JSON or create new

See the Agents Guide for full agent documentation.


Profiles Tab

Manage optimization profiles that control how prompts are structured.

Auto/Manual Toggle

ModeBehavior
AutoSmart Detection picks the best profile
ManualYou select a fixed profile

Profile Auto-Detection Pool

When enabled, Smart Detection can choose from all enabled profiles. Disable specific profiles to restrict which ones are available for auto-detection.

System / Custom Tabs

  • System: 32 built-in profiles (view details, cannot delete)
  • Custom: Your own profiles (create, edit, delete)

Profile Cards

Each profile card shows:

  • Icon and name
  • Cognitive mode (e.g., implementation, analysis, creative)
  • Verbosity level (compact, standard, extended, deep)
  • Badges for special features
  • Action buttons

Profile Wizard

Create custom profiles with:

PropertyDescription
NameProfile identifier
Cognitive ModePlanning, Implementation, Analysis, Creative, etc.
VerbosityCompact, Standard, Extended, Deep
StructureSectioned, Fluent, Checklist, Minimal
System PromptLLM instructions for this profile
TemperatureResponse creativity (0.0 = focused, 1.0 = creative)
Max TokensMaximum response length

Import/Export

  • Export: Save profiles as JSON for sharing
  • Import: Load profiles from JSON files