> ## 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.

# SmartBar

> Access AI assistance instantly with the Spotlight-like SmartBar

export const YouTubePlayer = ({videoId, title = "Video"}) => <Frame>
    <div id={`youtube-player-${videoId}`} style={{
  position: "relative",
  width: "100%",
  paddingBottom: "56.25%",
  borderRadius: "12px",
  overflow: "hidden",
  cursor: "pointer"
}} onClick={() => {
  const container = document.getElementById(`youtube-player-${videoId}`);
  container.innerHTML = `<iframe style="position:absolute;top:0;left:0;width:100%;height:100%;border:none;border-radius:12px" src="https://www.youtube.com/embed/${videoId}?autoplay=1" title="${title}" allow="accelerometer;autoplay;clipboard-write;encrypted-media;gyroscope;picture-in-picture" allowfullscreen></iframe>`;
}}>
      <img src={`https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`} alt={title} style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  objectFit: "cover"
}} />
      <div style={{
  position: "absolute",
  top: "50%",
  left: "50%",
  transform: "translate(-50%, -50%)",
  width: "68px",
  height: "48px",
  backgroundColor: "rgba(255, 0, 0, 0.9)",
  borderRadius: "14px",
  display: "flex",
  alignItems: "center",
  justifyContent: "center"
}}>
        <svg width="24" height="24" viewBox="0 0 24 24" fill="white">
          <path d="M8 5v14l11-7z" />
        </svg>
      </div>
    </div>
  </Frame>;

## Overview

SmartBar is EnConvo's flagship feature - a Spotlight-like interface that gives you instant access to AI assistance from anywhere on your Mac. It understands the context of your current work and provides intelligent suggestions.

<YouTubePlayer videoId="CZ9Oash0rMk" title="SmartBar Overview & Demo" />

## Opening SmartBar

Press `⇧⌘D` (Shift + Command + D) anywhere on your Mac to open SmartBar.

<Tip>
  You can customize this shortcut in Settings → SmartBar.
</Tip>

## Key Features

### Context-Aware Responses

> SmartBar automatically detects:

* **Active application**: Knows if you're in a browser, text editor, or other app
* **Browser tabs**: Can read and understand the content of your current webpage
* **Finder selections**: Recognizes selected files and folders
* **Clipboard content**: Can process recently copied text or images

> Manual context can be added with the `#` prefix:

* **#xcode**: Include the current Xcode project context
* **#safari**: Include the current Safari tab context
* **#screen**: Include the current screen content context
* **#browser**: Include the current browser content context

### Quick Commands

Type natural language commands to get instant results:

| Command           | Example                               |
| ----------------- | ------------------------------------- |
| Ask questions     | "What is the capital of France?"      |
| Summarize content | "Summarize this page"                 |
| Write content     | "Write a professional email about..." |
| Translate text    | "Translate to Spanish: Hello world"   |
| Calculate         | "Calculate 15% tip on \$85"           |
| Search            | "Search for React documentation"      |

### Plugin Integration

SmartBar integrates with 1000+ plugins. Type `@` to see available plugins:

```
@translate - Translate text to any language
@image - Generate images with AI
@ocr - Extract text from images and screen content
@fix-spelling - Fix spelling and grammar errors
@summarize - Summarize documents or webpages
```

### Voice Input

Use the microphone button or your dictation hotkey to speak directly into
SmartBar. This is useful for short agent commands, quick follow-up questions,
or hands-free prompts while you are working in another app.

Voice input uses the dictation provider selected in **Settings → Dictation**.
For provider selection and troubleshooting, see [Dictation](/features/dictation).

### Update Button

When EnConvo detects a newer version for your selected update channel, SmartBar
can show an **Update** button in the titlebar. Click it to open the update flow.

<Note>
  Update checks run in the background when SmartBar is shown and are throttled so
  the same check is not repeated more than once within 10 minutes.
</Note>

For channel setup, see [Updates](/configuration/updates).

## Using SmartBar

<Steps>
  <Step title="Open SmartBar">
    Press `⇧⌘D` to open the SmartBar overlay
  </Step>

  <Step title="Enter your query">
    Type your question, command, or use a plugin prefix
  </Step>

  <Step title="Add context (optional)">
    * Press `#` to add available context
    * Press `@` to add tools as context
  </Step>

  <Step title="Execute">
    Press `Enter` to submit your query and receive a response
  </Step>
</Steps>

## Context Modifiers

Enhance your queries with context modifiers:

| Modifier     | Usage                            | Description                     |
| ------------ | -------------------------------- | ------------------------------- |
| `#screen`    | Include current screen           | Adds screenshot context         |
| `#finder`    | Include current Finder selection | Adds selected files and folders |
| `#clipboard` | Include clipboard content        | Adds copied content             |
| `#browser`   | Include current browser tab      | Adds webpage content            |

## Keyboard Shortcuts

| Shortcut | Action              |
| -------- | ------------------- |
| `⇧⌘D`    | Open/Close SmartBar |
| `⌘ N`    | New conversation    |
| `⌘ P`    | Pin/Unpin SmartBar  |
| `↑ / ↓`  | Navigate history    |

## Mentions And Model Switching

SmartBar supports quick routing while you type:

| Input    | Use it for                                                                        |
| -------- | --------------------------------------------------------------------------------- |
| `@`      | Mention plugins, apps, websites, Knowledge Base content, or other context sources |
| `/`      | Open command and model shortcuts                                                  |
| `Return` | Submit the current request or confirm the selected mention/command                |

If you mention a command or model, SmartBar keeps the routing attached to the
current prompt so the response uses the intended tool or provider.

## Built-in Calculator

SmartBar includes an inline calculator. Type any math expression directly into the SmartBar input:

```
2+3*4       → 14
sqrt(144)   → 12
sin(45)     → 0.7071...
100/3       → 33.333...
```

When a math expression is detected, SmartBar shows a calculator result card with:

* The expression and computed result
* An operation label describing the calculation
* Press **Enter** to copy the result to your clipboard

<Tip>
  The calculator uses JavaScriptCore for safe expression evaluation, supporting standard arithmetic, trigonometric functions, and more.
</Tip>

## Tips & Tricks

<AccordionGroup>
  <Accordion title="Use natural language">
    SmartBar understands natural language. Instead of keywords, ask complete questions like "How do I center a div in CSS?" or "What's the weather like today?"
  </Accordion>

  <Accordion title="Chain commands">
    You can chain multiple actions: "Translate this to French, then summarize it in 3 bullet points"
  </Accordion>

  <Accordion title="Quick copy">
    Press `⌘⇧ C` to copy the AI response, or click the copy button
  </Accordion>
</AccordionGroup>

## Related Features

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

  <Card title="Context Awareness" icon="eye" href="/features/context-awareness">
    Learn how EnConvo understands your screen
  </Card>
</CardGroup>