> ## Documentation Index
> Fetch the complete documentation index at: https://alexcode.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Mode

> Use voice commands to interact with Alex Sidebar more naturally

## Overview

Voice Mode allows you to interact with Alex Sidebar using speech instead of typing, making code discussions more natural and efficient. This feature is particularly useful when you need to explain complex problems or want to reduce typing fatigue.

<Frame>
  <img src="https://mintcdn.com/alex/MU0ta-NVGMnBtJHm/images/voice-mode.png?fit=max&auto=format&n=MU0ta-NVGMnBtJHm&q=85&s=445e45e3e76b2fafde6b9fc8f8db59a9" alt="Voice mode interface showing microphone button and transcription" width="1194" height="730" data-path="images/voice-mode.png" />
</Frame>

## Quick Actions

<CardGroup cols={2}>
  <Card title="Command + Shift + V" icon="microphone">
    Toggle voice recording on/off. Use this shortcut to quickly start or stop voice input without clicking.
  </Card>

  <Card title="Microphone Button" icon="circle-microphone">
    Click the microphone icon in the chat input area to start/stop recording.
  </Card>
</CardGroup>

## Using Voice Mode

<Steps>
  <Step title="Enable Voice Mode">
    1. Open Settings (gear icon)
    2. Navigate to Chat Settings
    3. Enable Voice Mode

    <Frame>
      <img src="https://mintcdn.com/alex/zS4a0pdjtofRLVUw/images/voice-settings.png?fit=max&auto=format&n=zS4a0pdjtofRLVUw&q=85&s=f97503bcfe32fe224add67fbc8358892" alt="Voice mode interface showing microphone button and transcription" width="1194" height="1122" data-path="images/voice-settings.png" />
    </Frame>

    <Note>
      Voice Mode requires microphone permissions. You will be prompted to grant access when first enabling this feature.
    </Note>
  </Step>

  <Step title="Start Recording">
    Two ways to start:

    * Press **Command + Shift + V**
    * Click the microphone icon

    <Frame>
      <img src="https://mintcdn.com/alex/MU0ta-NVGMnBtJHm/images/voice-recording-button.png?fit=max&auto=format&n=MU0ta-NVGMnBtJHm&q=85&s=f59ded018d66466d9ae97e866dda36c5" alt="Voice recording button in chat interface" width="1194" height="736" data-path="images/voice-recording-button.png" />
    </Frame>
  </Step>

  <Step title="Speak Your Message">
    Speak clearly into your microphone.
  </Step>

  <Step title="Stop Recording">
    Use any of these methods to stop:

    * Press **Command + Shift + V** again
    * Click the microphone icon
    * Press **Return/Enter** key
    * Press **Escape** key to cancel recording

    Your speech will be automatically transcribed and inserted into the chat input box.

    <Frame>
      <img src="https://mintcdn.com/alex/zS4a0pdjtofRLVUw/images/voice-transcribing-button.png?fit=max&auto=format&n=zS4a0pdjtofRLVUw&q=85&s=8191a8fff3b1871263144b93e58bac4c" alt="Voice transcribing indicator showing speech-to-text conversion in progress" width="1194" height="736" data-path="images/voice-transcribing-button.png" />
    </Frame>

    <Note>
      Use the Escape key if you want to cancel the recording without transcribing the audio.
    </Note>
  </Step>
</Steps>

## Auto Mode

<Frame>
  <img src="https://mintcdn.com/alex/zS4a0pdjtofRLVUw/images/voice-settings.png?fit=max&auto=format&n=zS4a0pdjtofRLVUw&q=85&s=f97503bcfe32fe224add67fbc8358892" alt="Voice mode interface showing microphone button and transcription" width="1194" height="1122" data-path="images/voice-settings.png" />
</Frame>

Enable "Auto Mode" in settings to automatically send transcribed messages:

* Finish speaking and stop recording
* Press Return/Enter
* Message sends automatically and starts AI inference

<Frame>
  <img src="https://mintcdn.com/alex/MU0ta-NVGMnBtJHm/images/voice-auto-mode.png?fit=max&auto=format&n=MU0ta-NVGMnBtJHm&q=85&s=03aa4a950a2089c0d3ab8e28ce2f0120" alt="Voice auto mode interface showing automatic message sending after transcription" width="1194" height="710" data-path="images/voice-auto-mode.png" />
</Frame>

## Best Practices

<CardGroup cols={2}>
  <Card title="Clear Speech" icon="waveform">
    * Speak at a natural pace
    * Enunciate clearly
    * Avoid background noise
    * Use technical terms carefully
  </Card>

  <Card title="Efficient Workflow" icon="arrows-rotate">
    * Use voice for longer explanations
    * Review transcription before sending
    * Combine with code selection
  </Card>
</CardGroup>

## Accessibility Benefits

Voice Mode makes Alex more accessible and easier to use for everyone.

* When you are coding for long periods, **Voice Mode** lets you take breaks from typing while staying productive.

* For developers with mobility challenges or strain injuries, voice input provides a comfortable way to interact with Alex. You can dictate code explanations and questions instead.

* Having voice as an additional input option means you can choose what works best for you in different situations. Sometimes speaking is just more convenient than typing.

And when you need to explain complex concepts or walk through detailed logic, speaking it out loud often feels more natural and fluid than typing it all out.
