> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Teeflo/PolyChat-AI/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyboard Shortcuts

> Master all keyboard shortcuts in PolyChat-AI for efficient workflows and faster navigation

## Overview

PolyChat-AI supports keyboard shortcuts to streamline your workflow and reduce reliance on mouse interactions. All shortcuts work on both Windows/Linux (`Ctrl`) and macOS (`Cmd`).

<Note>
  Throughout this guide, `Ctrl/Cmd` means:

  * **Windows/Linux**: `Ctrl` key
  * **macOS**: `Cmd` (⌘) key
</Note>

## Global Shortcuts

These shortcuts work anywhere in the application:

| Shortcut       | Action               | Description                                             |
| -------------- | -------------------- | ------------------------------------------------------- |
| `Ctrl/Cmd + K` | Open Settings        | Opens the settings modal with all configuration options |
| `Ctrl/Cmd + U` | Open Usage Dashboard | View detailed usage statistics and analytics            |
| `Ctrl/Cmd + N` | New Conversation     | Starts a fresh conversation with the selected model     |
| `Ctrl/Cmd + S` | Save Conversation    | Saves the current conversation to history               |
| `Ctrl/Cmd + /` | Show Help            | Displays keyboard shortcuts and help information        |

### Usage Examples

<Steps>
  <Step title="Quick Settings Access">
    Press `Ctrl/Cmd + K` at any time to instantly open settings without reaching for your mouse.
  </Step>

  <Step title="Check Usage Stats">
    Use `Ctrl/Cmd + U` to view:

    * Total conversations created
    * Messages exchanged (user and assistant)
    * Average response time
    * Per-model statistics
  </Step>

  <Step title="Rapid Conversation Switching">
    Press `Ctrl/Cmd + N` to quickly start a new conversation thread without interrupting your workflow.
  </Step>
</Steps>

## Settings Modal Shortcuts

When the settings modal is open (after pressing `Ctrl/Cmd + K`):

### Model Selection

| Action        | Shortcut | Description                        |
| ------------- | -------- | ---------------------------------- |
| Navigate Down | `↓`      | Move to next model in the list     |
| Navigate Up   | `↑`      | Move to previous model in the list |
| Select Model  | `Enter`  | Select the currently focused model |
| Search Models | Type     | Filter models by name or provider  |
| Clear Search  | `Esc`    | Clear the search field             |

### Workflow Example

<Accordion title="Efficient Model Selection">
  1. Press `Ctrl/Cmd + K` to open settings
  2. Type "claude" to filter models
  3. Use `↓` and `↑` to navigate results
  4. Press `Enter` to select desired model
  5. Press `Esc` to close settings

  **Total time**: \~3 seconds
</Accordion>

### General Navigation

| Shortcut      | Action           | Description                            |
| ------------- | ---------------- | -------------------------------------- |
| `Tab`         | Next Field       | Move focus to the next input field     |
| `Shift + Tab` | Previous Field   | Move focus to the previous input field |
| `Esc`         | Close Modal      | Close settings without saving changes  |
| `Enter`       | Save (on button) | Save settings and close modal          |

## Chat Input Shortcuts

These shortcuts work when the chat input field is focused:

| Shortcut           | Action            | Description                                      |
| ------------------ | ----------------- | ------------------------------------------------ |
| `Enter`            | Send Message      | Send the current message (if multiline disabled) |
| `Shift + Enter`    | New Line          | Insert a line break within the message           |
| `Ctrl/Cmd + Enter` | Force Send        | Send message even in multiline mode              |
| `↑`                | Edit Last Message | Edit your most recent message                    |
| `Esc`              | Clear Input       | Clear the current message draft                  |

### Multiline Message Composition

<Steps>
  <Step title="Start Your Message">
    Click the chat input or start typing to focus it.
  </Step>

  <Step title="Add Line Breaks">
    Press `Shift + Enter` to create line breaks for formatted messages:

    ```
    Here's my question:

    1. How do I implement feature X?
    2. What are the best practices?
    3. Are there performance considerations?
    ```
  </Step>

  <Step title="Send When Ready">
    Press `Ctrl/Cmd + Enter` to send your multiline message.
  </Step>
</Steps>

## Model Switcher Shortcuts

When the model switcher dropdown is open:

| Shortcut | Action         | Description                           |
| -------- | -------------- | ------------------------------------- |
| `↓`      | Next Model     | Highlight next model in dropdown      |
| `↑`      | Previous Model | Highlight previous model in dropdown  |
| `Enter`  | Select Model   | Switch to the highlighted model       |
| `Esc`    | Close Dropdown | Close model switcher without changing |
| Type     | Filter         | Search models by typing               |

## Browser Navigation

Standard browser shortcuts that work with PolyChat-AI:

| Shortcut               | Action       | Description                                 |
| ---------------------- | ------------ | ------------------------------------------- |
| `Ctrl/Cmd + R`         | Refresh Page | Reload the application (preserves settings) |
| `Ctrl/Cmd + Shift + R` | Hard Refresh | Clear cache and reload                      |
| `F11`                  | Fullscreen   | Toggle fullscreen mode (browser dependent)  |
| `Ctrl/Cmd + +`         | Zoom In      | Increase interface size                     |
| `Ctrl/Cmd + -`         | Zoom Out     | Decrease interface size                     |
| `Ctrl/Cmd + 0`         | Reset Zoom   | Return to default zoom level                |

## Template Shortcuts

When using conversation templates:

<AccordionGroup>
  <Accordion title="Template Selection">
    1. Click template icon in chat input
    2. Use `↓`/`↑` to navigate categories
    3. Press `Enter` to expand category
    4. Use `↓`/`↑` to select template
    5. Press `Enter` to apply template
  </Accordion>

  <Accordion title="Quick Actions">
    Quick actions appear when text is selected:

    * Select text in a message
    * Quick action buttons appear above selection
    * Click desired action or use `Tab` to navigate
    * Press `Enter` to apply action
  </Accordion>
</AccordionGroup>

## Advanced Shortcuts

### Developer Tools

| Shortcut               | Action          | Description                       |
| ---------------------- | --------------- | --------------------------------- |
| `F12`                  | Open DevTools   | Open browser developer tools      |
| `Ctrl/Cmd + Shift + I` | Open DevTools   | Alternative shortcut for DevTools |
| `Ctrl/Cmd + Shift + C` | Inspect Element | Inspect specific UI elements      |

### Accessibility Shortcuts

| Shortcut      | Action         | Description                                |
| ------------- | -------------- | ------------------------------------------ |
| `Tab`         | Focus Next     | Move focus to next interactive element     |
| `Shift + Tab` | Focus Previous | Move focus to previous interactive element |
| `Space`       | Activate       | Activate focused button or toggle          |
| `Enter`       | Activate       | Activate focused link or button            |

## Custom Shortcut Workflow Examples

### Workflow 1: Quick Model Comparison

<Steps>
  <Step title="Enable Multi-Model Mode">
    Click the multi-model grid icon in the header.
  </Step>

  <Step title="Select Models">
    * Press `Ctrl/Cmd + K`
    * Type "gpt" and press `Enter` to select GPT-4
    * Press `Ctrl/Cmd + K` again
    * Type "claude" and press `Enter` to select Claude
    * Repeat for third model
  </Step>

  <Step title="Send Comparison Query">
    Type your question and press `Ctrl/Cmd + Enter` to see responses from all three models simultaneously.
  </Step>
</Steps>

### Workflow 2: Rapid Conversation Management

<Steps>
  <Step title="Start New Topic">
    Press `Ctrl/Cmd + N` to start a fresh conversation.
  </Step>

  <Step title="Save Important Conversations">
    After a valuable exchange, press `Ctrl/Cmd + S` to save to history.
  </Step>

  <Step title="Access Saved Conversations">
    Click history icon in header to browse saved conversations with search functionality.
  </Step>
</Steps>

### Workflow 3: Focused Settings Configuration

<Steps>
  <Step title="Open Settings">
    Press `Ctrl/Cmd + K`
  </Step>

  <Step title="Navigate Efficiently">
    * Use `Tab` to move between sections
    * Type to search in model selector
    * Use `↓`/`↑` for model navigation
    * Press `Enter` to select
  </Step>

  <Step title="Save and Continue">
    Tab to "Save" button and press `Enter`, or press `Esc` to cancel.
  </Step>
</Steps>

## Productivity Tips

<CardGroup cols={2}>
  <Card title="Minimize Mouse Usage" icon="keyboard">
    Master `Ctrl/Cmd + K` and arrow key navigation to configure settings without touching your mouse.
  </Card>

  <Card title="Quick Context Switching" icon="zap">
    Use `Ctrl/Cmd + N` to rapidly switch between different topics without cluttering a single conversation.
  </Card>

  <Card title="Monitor Usage" icon="chart-bar">
    Regularly check `Ctrl/Cmd + U` to track which models work best for your use cases.
  </Card>

  <Card title="Save Important Work" icon="save">
    Make `Ctrl/Cmd + S` a habit after valuable exchanges to build a searchable knowledge base.
  </Card>
</CardGroup>

## Keyboard Shortcut Reference Card

Print or bookmark this quick reference:

```
╔════════════════════════════════════════════════════════════╗
║           POLYCHAT-AI KEYBOARD SHORTCUTS                   ║
╠════════════════════════════════════════════════════════════╣
║ GLOBAL                                                     ║
║ • Ctrl/Cmd + K .......... Open Settings                   ║
║ • Ctrl/Cmd + U .......... Usage Dashboard                 ║
║ • Ctrl/Cmd + N .......... New Conversation                ║
║ • Ctrl/Cmd + S .......... Save Conversation               ║
║ • Ctrl/Cmd + / .......... Show Help                       ║
╠════════════════════════════════════════════════════════════╣
║ SETTINGS MODAL                                             ║
║ • ↓ / ↑ ................. Navigate Models                 ║
║ • Enter ................. Select Model                     ║
║ • Esc ................... Close Modal                      ║
║ • Tab ................... Next Field                       ║
╠════════════════════════════════════════════════════════════╣
║ CHAT INPUT                                                 ║
║ • Enter ................. Send Message                     ║
║ • Shift + Enter ......... New Line                        ║
║ • Ctrl/Cmd + Enter ...... Force Send                      ║
║ • ↑ ..................... Edit Last Message               ║
║ • Esc ................... Clear Input                     ║
╚════════════════════════════════════════════════════════════╝
```

## Customization

<Warning>
  Currently, PolyChat-AI does not support custom keyboard shortcut configuration. All shortcuts are hard-coded for consistency. Custom shortcuts may be added in a future release.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Shortcut Not Working">
    **Possible Causes**:

    * Another browser extension is intercepting the shortcut
    * Operating system global shortcut conflicts
    * Browser is not focused

    **Solutions**:

    * Disable conflicting browser extensions
    * Check OS keyboard settings
    * Click anywhere in the PolyChat-AI window to ensure focus
  </Accordion>

  <Accordion title="Model Navigation Not Responding">
    **Issue**: Arrow keys don't navigate model list

    **Solution**: Ensure the search input in the model selector has focus. Click it first, then use arrow keys.
  </Accordion>

  <Accordion title="Send Shortcut Confusion">
    **Issue**: Not sure when to use `Enter` vs `Ctrl/Cmd + Enter`

    **Explanation**:

    * Single-line messages: `Enter` sends
    * Multi-line messages: `Shift + Enter` for new line, `Ctrl/Cmd + Enter` to send
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="key" href="/guides/configuration">
    Learn how to set up API keys and configure models
  </Card>

  <Card title="Customization" icon="palette" href="/guides/customization">
    Personalize themes and conversation settings
  </Card>
</CardGroup>