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

# Window Management

> Customize how Enconvo appears and behaves on your screen

## Overview

EnConvo offers multiple panel modes that control how the AI interface appears on your screen. Whether you prefer a compact search bar, a persistent sidebar, or a floating chat window, you can choose the layout that best fits your workflow and switch between modes at any time.

## Panel Modes

EnConvo provides the following display modes:

<CardGroup cols={2}>
  <Card title="Smart Bar" icon="magnifying-glass">
    Spotlight-like overlay that appears center-screen on demand
  </Card>

  <Card title="Mini Smart Bar" icon="minus">
    Compact, minimal search bar for quick queries
  </Card>

  <Card title="Side Bar" icon="sidebar">
    Full-height panel docked to the screen edge
  </Card>

  <Card title="App Sidebar" icon="window-maximize">
    Sidebar attached to the active application window
  </Card>
</CardGroup>

### Smart Bar

The default mode. A Spotlight-style overlay that appears at the center of your screen when you press the hotkey (`Shift+Cmd+D`). It disappears after your query is processed or when you press `Escape`.

**Best for**: Quick, one-off queries and commands. Minimal screen disruption.

| Feature     | Detail                       |
| ----------- | ---------------------------- |
| Activation  | `Shift+Cmd+D` (customizable) |
| Position    | Center screen                |
| Persistence | Disappears after use         |
| Context     | Full context awareness       |

### Mini Smart Bar

A more compact version of the Smart Bar. Takes up less screen space while still providing full AI access. Ideal for users who want a less intrusive interface.

**Best for**: Frequent short queries, users who prefer minimal UI.

| Feature     | Detail                                   |
| ----------- | ---------------------------------------- |
| Position    | Top of screen (customizable)             |
| Size        | Compact, single-line input               |
| Persistence | Configurable (auto-hide or stay visible) |

### Side Bar

A full-height panel that docks to the left or right edge of your screen. Provides a persistent chat interface alongside your other applications.

**Best for**: Extended conversations, reference material, ongoing tasks.

| Feature      | Detail                      |
| ------------ | --------------------------- |
| Position     | Left or right screen edge   |
| Size         | Adjustable width            |
| Persistence  | Always visible until closed |
| Chat history | Full conversation view      |

### App Sidebar

A sidebar that attaches directly to the active application window rather than the screen edge. Each application gets its own AI context, making the sidebar app-aware.

**Best for**: Per-app AI assistance, code editors, browsers, document editing.

| Feature     | Detail                                 |
| ----------- | -------------------------------------- |
| Activation  | `Shift+Cmd+T` or click the hint button |
| Position    | Attached to active app window          |
| Context     | Automatically adapts to each app       |
| Persistence | Stays with the app window              |

See [App Sidebar](/features/app-sidebar) for detailed documentation.

## Switching Panel Modes

### From Settings

1. Open **Settings** in EnConvo
2. Navigate to the window or display settings
3. Select your preferred panel mode from the dropdown

### From Quick Actions

You can switch modes quickly:

* Right-click the EnConvo menu bar icon and select a panel mode
* Use a keyboard shortcut to cycle between modes (if configured)

## Window Positioning

### Fixed Position

Pin the panel to a specific location on your screen:

1. Drag the panel to your preferred position
2. Click the pin icon to lock it in place
3. The panel will remember its position between sessions

### Multi-Monitor Support

EnConvo works across multiple displays:

* The SmartBar appears on the display where your cursor is located
* Sidebars can be docked to any display edge
* The App Sidebar follows the application window, even across monitors
* Each monitor can have independent positioning preferences

<Tip>
  If you use multiple monitors, the SmartBar always appears on the active monitor (where your mouse cursor is). This ensures it is always within reach regardless of which screen you are focused on.
</Tip>

## Appearance Settings

### Transparency

Adjust the window opacity to let your background content show through:

* **Full opacity**: Solid background, easiest to read
* **Semi-transparent**: See your work behind the panel
* **Highly transparent**: Minimal visual obstruction

### Size Adjustment

Resize the panel to match your preference:

| Mode           | Resizable        | Default Size |
| -------------- | ---------------- | ------------ |
| Smart Bar      | Width adjustable | Medium       |
| Mini Smart Bar | Fixed compact    | Small        |
| Side Bar       | Width adjustable | \~350px      |
| App Sidebar    | Width adjustable | \~300px      |

Drag the edge of the panel to resize it. The size is remembered between sessions.

### Always-on-Top

Keep the EnConvo panel above all other windows:

1. Right-click the panel title bar or menu bar icon
2. Toggle **Always on Top**
3. The panel will float above all other application windows

This is particularly useful for:

* Referencing AI responses while working in another application
* Keeping a conversation visible during video calls
* Monitoring ongoing tasks or workflows

## Keyboard Shortcuts

| Shortcut      | Action                 |
| ------------- | ---------------------- |
| `Shift+Cmd+D` | Open/close Smart Bar   |
| `Shift+Cmd+T` | Open/close App Sidebar |
| `Cmd+N`       | New conversation       |
| `Cmd+P`       | Pin/Unpin panel        |
| `Cmd+W`       | Close current panel    |
| `Escape`      | Dismiss Smart Bar      |

<Tip>
  All keyboard shortcuts can be customized in **Settings** -> **Keyboard Shortcuts**. You can assign different shortcuts for different panel modes.
</Tip>

## Configuration Reference

### Settings -> Window

| Setting                  | Description                       | Options                                                |
| ------------------------ | --------------------------------- | ------------------------------------------------------ |
| **Default Mode**         | Panel mode on launch              | Smart Bar, Mini Smart Bar, Side Bar, App Sidebar, None |
| **Smart Bar Position**   | Where the Smart Bar appears       | Center, Top, Custom                                    |
| **Sidebar Position**     | Which screen edge for the sidebar | Left, Right                                            |
| **Always on Top**        | Float above other windows         | On / Off                                               |
| **Opacity**              | Window transparency level         | 0% - 100%                                              |
| **Auto-hide**            | Collapse when not in use          | On / Off                                               |
| **Show on All Desktops** | Visible across macOS Spaces       | On / Off                                               |

### None Mode

Setting the display mode to **None** hides all panels. EnConvo continues running in the background and can still be activated via:

* Menu bar icon
* Keyboard shortcuts
* Companion Orb (if enabled)
* Workflows and automations

## Tips and Tricks

<AccordionGroup>
  <Accordion title="Match mode to task" icon="bullseye">
    Use Smart Bar for quick lookups and one-shot commands. Switch to Side Bar or App Sidebar when you need an ongoing conversation or want to keep AI responses visible while working.
  </Accordion>

  <Accordion title="Use App Sidebar for coding" icon="code">
    The App Sidebar is especially powerful with code editors. It automatically detects the programming language and file context, providing targeted assistance without you needing to explain what you are working on.
  </Accordion>

  <Accordion title="Combine with Companion Orb" icon="circle">
    The Companion Orb works alongside any panel mode. Use the Smart Bar for commands and the Companion Orb for voice chat and quick actions simultaneously.
  </Accordion>

  <Accordion title="Reduce distraction" icon="eye-slash">
    If you find the panel distracting, increase transparency, enable auto-hide, or use Mini Smart Bar mode. You get the same AI capabilities with minimal visual impact.
  </Accordion>
</AccordionGroup>

## Related Features

<CardGroup cols={2}>
  <Card title="SmartBar" icon="magnifying-glass" href="/features/smartbar">
    Smart Bar detailed documentation
  </Card>

  <Card title="App Sidebar" icon="sidebar" href="/features/app-sidebar">
    App Sidebar detailed documentation
  </Card>

  <Card title="Companion Orb" icon="circle" href="/features/companion-bar">
    Floating AI companion
  </Card>

  <Card title="PopBar" icon="window-restore" href="/features/popbar">
    Context menu for selected text
  </Card>
</CardGroup>
