Usage

The fastest way to start a conversation

Quick Entry is a floating window you can invoke from any app without switching focus. Type your request and press Return — a conversation window opens automatically.

The default hotkey is ⌥⌘O. Change it in Settings → General → Shortcuts — click the badge and press any key combo with at least one modifier.

Session list and quick actions

Click the OScar icon in the menu bar to open the session list. From here you can:

— Open a past conversation by clicking its name
— Start a new conversation with the + button
— Open Settings
— Quit OScar

The session list shows your 20 most recent sessions sorted by last activity. Sessions with unread streaming are highlighted.

Chatting with your agent

Each conversation opens in its own window. Windows are independent — you can run several agents in parallel on different tasks.

While a response is streaming you can continue typing. Sending another message interrupts the current stream and starts fresh.

Tool calls appear inline as collapsible rows. Expand them to see exact shell commands, file paths, or MCP calls the agent made.

Finding sessions with ⌘Space

OScar indexes every session in Spotlight. Search for any topic you've discussed — results show the session title and message count. Clicking a result opens the conversation window directly.

App Intents integration

OScar registers two App Intents that appear in Spotlight and Siri:

"Ask Oscar about…" — opens Quick Entry with a prefilled query.
"Continue last session" — reopens the most recent conversation window.

These phrases work from the Spotlight search bar and from the Shortcuts app. You can chain them into automations — for example, trigger a daily briefing from a calendar event.

Choosing an agent per conversation

The Quick Entry window shows an agent picker in the bottom left. Click it to choose from:

Default — whatever agent is set in Settings.
Sandboxes — preset sandbox variants (Cagent-box, Claude-box, …).
Agents — any YAML files found in your configured agents folder.

Type in the search box to filter. The chosen agent is remembered per session — reopening a conversation always uses the same agent it was started with.

Key settings to know