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

> Ask an Agent a question or run a command from any app with one shortcut.

SmartBar is a launcher you open from any app to ask an Agent a question or run a command. Press **⇧⌘D**, type, and press Return. Reach for it when you want a quick answer and then get back to what you were doing.

For other jobs, use the [Chat Window](https://docs.enconvo.ai/ai/chat.md) for long conversations and files, the [App Sidebar](https://docs.enconvo.ai/features/app-sidebar.md) to work beside one app, [PopBar](https://docs.enconvo.ai/features/popbar.md) to act on selected text, or the [Dynamic Island](https://docs.enconvo.ai/features/dynamic-island.md) and [Desktop Pet](https://docs.enconvo.ai/features/pet.md) for a small entry point that stays on screen. [Window Management](https://docs.enconvo.ai/features/window-management.md) compares them all.

## Ask a question

1. Press **⇧⌘D**, or the hotkey you set in **Settings → SmartBar**.
2. Type your question. Pick another Agent or model first if you need one.
3. Attach the context the Agent needs. It doesn't see every open app; see [Add context](#add-context).
4. Press Return and follow the answer or the tool progress.
5. Copy the result, or type a follow-up to continue the conversation.

## Search with trigger characters

Type one of these characters in SmartBar to search one kind of item:

| Type | To |
| - | - |
| `@` | Search commands |
| `#` | Add context |
| `$` | Use a skill |
| `>` | Show recent tasks |
| `/` | Open actions, such as model and reasoning selection |

You can change the first four under **Search** in **Settings → SmartBar**. `/` can't be changed.

Pick items from the list that opens instead of typing a name from memory: the list shows the commands and context sources you actually have. See [Writing Toolkit](https://docs.enconvo.ai/features/writing-tools.md), [Quick Links](https://docs.enconvo.ai/features/quick-links.md), and [Context Awareness](https://docs.enconvo.ai/features/context-awareness.md).

## Add context

SmartBar can pick up the selected text, the Finder selection, and the current browser page when it opens. Choose **Attach**, **Suggest**, or **Off** for each one in **Settings → Context Awareness**. To add anything else, type `#` and pick a source.

## Choose a layout

![Input Only, Input and Toolbar, and Full Panel SmartBar layout choices](https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/images/guides/smartbar-layout.jpg?fit=max\&auto=format\&n=hQPNJJatkK6kD6HF\&q=85\&s=a0faf39b4b9d04b4867439a95a60df33)

SmartBar's three opening layouts. The highlighted layout is an example setting.

**Layout** in **Settings → SmartBar** sets what you see when SmartBar opens:

| Layout | What opens |
| - | - |
| **Input Only** | Just the input field |
| **Input and Toolbar** | The input, plus quick actions, the model picker, and voice controls |
| **Full Panel** | All of that, plus the list below the input |

With **Full Panel**, **Initial State View** sets what the list shows before you type: **Recommended Prompts** or **Command List**. In every layout, the list and results still appear once you type or run a command.

## Settings

Open **Settings → SmartBar**.

| Setting | What it changes |
| - | - |
| **Hotkey** | Opens and closes SmartBar from any app. The default is **⇧⌘D**. |
| **Default Agent** | The Agent that answers what you type. |
| **Auto Clear Conversation** | Starts a new conversation when SmartBar opens after being closed this long, from **Never** to **Every time it opens**. |
| **Layout** | What you see when SmartBar opens (see above). |
| **Appearance** | Light or dark glass for SmartBar and the App Sidebar, or **Follow App**. |
| **Auto-switch Input Source** | Switches to this input source while you type in SmartBar, and back when it closes. |
| **Navigation Bindings** | Control-key shortcuts for moving through lists and text: **macOS** (⌃N ⌃P ⌃F ⌃B) or **Vim** (⌃J ⌃K ⌃L ⌃H). |
| **Search** | The trigger characters for commands, context, skills, and recent tasks. |

Changing a default doesn't change every existing chat. [Model Selection](https://docs.enconvo.ai/ai/model-selection-guide.md) explains how each chat keeps its own model and reasoning choice.

## Voice and calculations

Click the microphone to speak your question with [Dictation](https://docs.enconvo.ai/features/dictation.md). For a spoken back-and-forth, start [Live Talk](https://docs.enconvo.ai/features/live-voice.md); a call you start from SmartBar moves to the Dynamic Island.

Type an arithmetic expression, such as `2+3*4`, and SmartBar shows the result. Check the result and the action it offers before you copy it.

## Troubleshooting

| Problem | What to do |
| - | - |
| SmartBar doesn't open | Check **Hotkey** in **Settings → SmartBar**, and look for another app that uses the same shortcut. |
| An app or the selected text is missing from the context | Check [Permissions](https://docs.enconvo.ai/configuration/permissions.md) and **Settings → Context Awareness**. |
| A request fails | Check the selected provider and read the error it reports. |
| A control on this page is missing | Your build may be older than this guide. See [Updates](https://docs.enconvo.ai/configuration/updates.md). |

## Related

> [card] [Chat Window](https://docs.enconvo.ai/ai/chat.md)
>
> Longer conversations with history, projects, and files.

> [card] [Dynamic Island](https://docs.enconvo.ai/features/dynamic-island.md)
>
> A compact input at the top of your screen.

> [card] [Context Awareness](https://docs.enconvo.ai/features/context-awareness.md)
>
> Choose what context Enconvo picks up.

> [card] [Keyboard Shortcuts](https://docs.enconvo.ai/configuration/keyboard-shortcuts.md)
>
> Change the shortcuts that open each window.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.