Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
      • Agent Mode
  • Active AI
  • Generate
  • Voice
  • Terminal
    • Appearance
      • Themes
      • Custom Themes
      • Prompt
      • Input Position
      • Text, Fonts, & Cursor
      • Size, Opacity, & Blurring
      • Pane Dimming & Focus
      • Blocks Behavior
      • Tabs Behavior
      • App Icons
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Find
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Command Palette
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • More Features
      • Accessibility
      • Files, Links, & Scripts
      • Markdown Viewer
      • Working Directory
      • Smart-Select
      • Full-screen Apps
      • Notifications & Audible Bell
      • Settings Sync (Beta)
      • Quit Warning
      • URI Scheme
      • Linux
    • Comparisons
      • Performance
      • Terminal features
  • Integrations
  • Knowledge & Collaboration
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Model Context Protocol
    • Rules
    • Teams
    • Session Sharing
  • Privacy
    • Privacy
    • Secret Redaction
    • Network Log
  • Community
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
  • Support & Billing
    • Sending Feedback & Logs
    • Plans & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • Getting Started with Voice
  • Initial Setup
  • Using Voice
  • Sample use cases
  • Privacy & Security
  • Usage Limits
  • Troubleshooting
  • Common Issues

Was this helpful?

Voice

Voice enables natural language interaction with Warp, letting you speak commands and queries directly to your terminal.

PreviousGenerateNextAppearance

Last updated 2 months ago

Was this helpful?

Warp's Voice feature transforms how you interact with your terminal, letting you naturally speak commands and questions instead of typing them. This is especially powerful when combined with Agent Mode for complex operations or when you need to explain longer scenarios.

Voice input functionality can be configured in Settings > AI > Voice. You can toggle voice input and select your preferred activation hotkey from pre-defined options.

Getting Started with Voice

Initial Setup

First-time users will need to grant microphone permissions:

  • On macOS: Accept the system permission prompt or allow Warp microphone access in System Settings > Privacy & Security > Microphone

  • On Windows: Allow Warp microphone access in Settings > Privacy & Security > Microphone

  • On Linux: Configure through system sound settings

Using Voice

There are two ways to activate Voice:

  1. Microphone Button in Agent Mode

    • Click the microphone icon in Agent Mode

    • Start speaking when the indicator shows it's listening

    • Click again to stop recording

  2. Hotkey Method

  • Press and hold the Fn key (configurable) to start recording

  • Speak your command or query while holding the key

  • Release the Fn key to stop recording and transcribe

  • Press and hold the ALT-RIGHT key (configurable) to start recording

  • Speak your command or query while holding the key

  • Release the ALT-RIGHT key to stop recording and transcribe

  • Press and hold the ALT-RIGHT key (configurable) to start recording

  • Speak your command or query while holding the key

  • Release the ALT-RIGHT key to stop recording and transcribe

Sample use cases

Voice input makes complex interactions with Agent Mode more natural and efficient. Instead of typing lengthy queries, you can speak naturally to accomplish various tasks. For example, you might ask "Create a new Node.js project, install Express and MongoDB, then set up a basic server with a health check endpoint," or "What's the difference between chmod and chown? Give me examples of when to use each one."

You can also describe multi-step system tasks like "Find all log files in my project that contain errors from the last 24 hours, create a summary of the errors, and email it to me." Agent Mode will help break down these requests into the necessary commands and provide detailed explanations.

Voice input is not limited to just Agent Mode - it works across all of Warp's input interfaces. Whether you're using the Find dialog to search through text, entering commands in the terminal, or working with other input editors, you can use voice commands to quickly input your text.

Privacy & Security

Usage Limits

Voice features have anti-abuse limits in place to ensure fair usage. These limits are subject to change as we continue to improve the service.

Troubleshooting

Common Issues

  1. Microphone not detected If your microphone isn't being detected, first check your system permissions to ensure Warp has access. You should also verify that your microphone is properly connected to your system. If issues persist, try restarting Warp to reset the connection.

  2. Poor transcription quality To improve transcription quality, try to minimize background noise in your environment. Position yourself closer to the microphone while speaking, and verify that your microphone input levels are properly adjusted in your system settings. For best results, speak clearly at a natural pace and use complete sentences to provide better context. When referring to specific file names or commands, enunciate them clearly. It's also recommended to review the transcription before sending to ensure accuracy.

  3. Feature not activating If the Voice feature isn't activating, confirm that your hotkey settings are correctly configured in Warp. Check for any conflicting keyboard shortcuts that might interfere with Voice activation. Also ensure that you're running the latest version of Warp, as older versions may have compatibility issues.

    If you are on an Enterprise plan, your administrator may have disabled Voice functionality, or it may be pending approval.

The transcription is powered by . Voice data is processed in real-time by Wispr Flow and is not retained as a recording after transcription.

Wispr Flow
Voice Demo
Voice settings panel showing hotkey configuration and voice input toggle options
Voice input works across Warp's editor interfaces, including the Find dialog and other input editors