←User Guide

AI Agent

The agent drawer is Blabble's built-in AI assistant, living on the right side of the window. Toggle it with ⌘].

Agent modes

⌘1

Full Agent

A full conversational AI that can search your messages, analyze conversations, and answer questions. Uses tools to look up relevant context from your chat history. Supports multi-turn conversations.

"What restaurants did Mike recommend last month?"

⌘2

Spell & Grammar

Paste or type text and get it corrected for spelling and grammar.

⌘3

Translate

Translates text into your system language (or another language you specify). Paste a message, drag a chat bubble, or type text to translate.

⌘4

Summarize

Condenses long text into a brief summary. Great for catching up on long email threads or group chats.

⌘5

Collect

Pushes text, messages, or documents into the agent conversation without prompting the AI. Gather notes incrementally, then switch to Full Agent mode when you're ready to ask a question.

Drop several chat bubbles over time, then switch to Full Agent and ask "Summarize the key points from everything above."

Drag and drop

The agent input field showing drag and drop hint
  • Chat bubbles: Drag a message bubble from the conversation view into the agent.
  • Mail messages: Drag an email bubble to add its full content to the agent context.
  • Attachments: Drag individual images, PDFs, or other files for the agent to analyze.
  • Documents: Drop files from Finder (PDFs, text files, images) directly into the agent input.

Agent conversations

Agent conversation controls showing Context, New Chat, and more
New conversation⌘⇧N
Rename conversation⌘⇧R
Clear conversation⌘⇧⌫
Delete conversation⌘⇧⌥⌫

Agent context

Each conversation has a shared context panel, a place for persistent background information that applies to all agent conversations within it. Open it by clicking the Context button in the agent controls bar.

Tip: Keep context concise. Everything in the context panel is sent with every request, using up part of the model's context window. A few sentences or bullet points is ideal.
Copy context⌘⇧⌥C
Paste context⌘⇧⌥V
Replace context⌘⇧⌃V
The Agent Context panel with placeholder text explaining persistent context

What the agent sees

When you send a message, the AI receives three layers of input:

  • Messages: The messages visible in the selected conversation.
  • User Context: The persistent context text you've written for this conversation.
  • Agent conversation history: The back-and-forth within that specific agent conversation.

Agent conversations are isolated from each other. They do not share history.

Diagram showing how user messages and user context flow into the agent drawer, and how each agent conversation is isolated with its own history
Important: When you use a server-based provider (OpenAI, Anthropic, or Gemini), all currently visible messages and any attachments you include are sent to that provider's servers. Review the provider's privacy policy before use. For maximum privacy, use Apple Intelligence or a local model.