Skip to main content
Describe what you want in the chat panel, and Qualia writes the code, runs it, and shows you the results. Each chat is an agent, a conversation that can work on its own and hand work to other agents.

Send a message

Type a message in the chat box at the bottom of the panel. Qualia reads your message and the current state of your notebook. Then it writes and runs code, and shows plots, tables, and text inline. For example:
  • “Load sales_data.csv and show summary statistics grouped by region.”
  • “Plot daily revenue with a 7-day moving average.”
  • “Compare random forest and logistic regression with 5-fold cross-validation.”
  • “Find out why the model performs poorly on some segments, and report back.”
Open-ended goals like the last one work best with higher Curiosity, Independence, and Parallelism; see Research style. With Web search on in Settings > Agents, Qualia can also look up documentation and references. Depending on the execution mode you choose, the agent runs code in notebook cells or as standalone scripts. Qualia keeps the conversation history, so you can refer back to earlier results and refine them. If a chat fails to load, choose Retry. You can inspect and edit any code Qualia runs. Expand an activity group in the chat to see its actions and results.

Start from a file or folder

The new chat screen offers three starting points that ask for a path and then hand it to an agent:
  • Explore a dataset asks for one data file. Qualia profiles it and reports its grain, its quality problems, and the questions it can answer. Checks adapt to the data, such as tabular, time series, text, image, geospatial, or graph data.
  • Teach Qualia your workflow asks for a file or folder, then turns a process you already run into a reusable skill.
  • Import knowledge accepts files, folders, links, or notes, and turns past work into claims, the findings Qualia records with their evidence.
In Qualia Cloud, the picker browses your cloud workspace. Use Upload, or drag files onto the picker, to add them to the current folder.

Queue follow-ups

While the agent works, type a message and click Queue follow-up. By default, the agent reads queued messages at its next step, which can come before the current cell finishes. To hold them until the agent finishes instead, set Queued messages to New turn in Settings > Agents. Queued messages appear above the chat box. You can edit, reorder, or remove them, or send one right away. If you stop the agent, its queue stays. When a shell command prints a lot, the chat shows its first and last parts. The agent can still read the full output without rerunning the command.

Answer questions

When Qualia asks a question, a card appears above the chat box. You can answer in three ways:
  • Pick an option, then press Next or Submit.
  • Type your own answer in the chat box and press Enter. While a question is open, the chat box answers it instead of sending a new message.
  • Choose Use best judgment to let Qualia decide.
If there are several questions, use the arrows at the top of the card to move between them. Qualia sends all your answers together when you submit. If you don’t answer, a countdown starts. Pause it to take more time; typing also pauses it. If time runs out first, Qualia ignores unsent answers and uses its best judgment.

Approve commands

Before Qualia runs a shell command that isn’t trusted yet, a card shows the exact command with Run and Skip. To trust a command for good, open the arrow beside Run. See Command approvals for every option.

Attach context

Attach context to a message so Qualia knows exactly what you mean:
  • Cells: Select one or more notebook cells. Qualia sees both your code and its output.
  • Files: Attach files and images from your computer.
  • Table selections: Select the rows or columns you care about in a data table and attach them.
  • Highlighted text: Select text in a file, a cell, a cell’s text output, or a terminal. Choose Add to chat in the selection toolbar, or press Cmd+L on macOS or Ctrl+L on Windows and Linux. A chip names the source; click it to reopen the source.
  • Earlier messages: Select text in the chat and choose Reply. The quoted passage stays attached to your message. For a notebook cell, use the cell’s Chat about this cell action.
  • Writeup passages: Select text and click the Qualia icon in the floating menu, then write your request in the comment. Qualia replies in that thread with suggested edits. See Comments and suggestions.
  • Image regions: Hold Cmd on macOS or Ctrl on Windows and Linux, and drag on a plot or chat image to attach only that region.
Qualia doesn’t send your current selection automatically, so add it when it matters. Attach up to 10 files per message, each up to 50 MB. You can pick, paste, or drag several at once. To remove one before sending, click its ×. After you send, click an image preview once to focus it, then again to open it in the image viewer. Click any other file’s chip to download a copy.

Choose a model

  1. Click the model name at the bottom of the chat box, or the robot icon when the chat panel is narrow.
  2. Choose a Frontier model, or select All models to browse the full catalog of models available to your account.
  3. To change which model new chats start with, hover a model and choose Set default. The current default shows Default.
Auto picks a strong model for you, so it keeps working as models change. To set agent models in Settings, see Agent models. Use the options menu beside the model picker to adjust its reasoning or thinking level. In narrow panels, these controls appear inside the model menu. Available levels depend on the model. Some models offer Fast mode, which lowers latency at premium provider pricing. It isn’t available on the Free plan.

Context window

The token usage indicator shows you how much of the model’s context window the chat uses. When the chat nears the limit, Qualia summarizes, or compacts, older history and continues. The agent may lose detail from early in the conversation. To compact sooner, type /compact, optionally followed by what to keep. For example: /compact keep the model comparison results. If the agent is running, compaction waits for its next step. In a chat with many images, the agent stops seeing the oldest ones, and Qualia tells you how to reopen them. Your chat history keeps every image. If you still reach the image limit, start a new chat.

Account usage limits

If your account reaches its usage limit, Qualia stops the current request and shows a message in chat. Choose View pricing in that message to compare plans with higher limits. To see how close you are, check your usage. To raise the limit, change your plan.

When a model declines a request

If a model refuses a request for safety reasons, Qualia ends the response and names the model. Switch to another model or start a new chat, because the same model will likely refuse again.

Research style

Research style controls how far Qualia explores, how often it asks you, how readily it splits work across agents, and how much detail it writes. Click Research style in the chat box to change them for one chat; changes apply from the agent’s next step. For each level and its default, see Research style. To let an agent work without approvals or questions, choose Auto ∞ under Independence. See Autonomous mode.

Browser tabs

In the desktop app, agents can open browser tabs, visit pages, click, and type. You approve each browser action first. Choose Always allow in this chat to skip the prompt for the rest of the chat. A cursor on the page shows you what the agent is doing. To open a browser tab yourself, choose File > New Browser Tab.

Code autocomplete

To get AI suggestions as you type in code cells, set Code completion to LM autocomplete in Settings > Editor. Press Tab to accept a suggestion. LM autocomplete requires signing in to Qualia and isn’t available with your own API keys.

Copy a message

Hover over a message and select Copy message beneath it. A copied reply pastes as formatted text in rich editors and as Markdown in plain-text editors. Your own messages copy as plain text.

Fork a chat

Fork a chat to copy it into a new tab, so you can branch off without changing the original.
  • Whole chat: open the … (Chat actions) menu and choose Fork chat.
  • Up to a reply: hover over a reply and choose Fork in new chat.
The fork keeps your model and research style. It drops auto-approve and Auto ∞, so commands in the fork ask you before running. That keeps the fork from racing the original in the same workspace.

Export a chat

To save a chat as a Markdown (.md) file, open the … (Chat actions) menu beside the chat tabs and choose Export. You can also right-click a chat tab. The export holds the visible transcript: your messages and Qualia’s replies. Use it to archive a conversation or share it outside the app. You can export from the desktop app and from Qualia Cloud. Cloud exports show each participant’s name beside their messages.

Customize Qualia

  • Rules: persistent instructions for every chat, such as “Always use polars instead of pandas.”
  • Skills: reusable workflows for a specific kind of task, such as analyzing a time series.
  • Hooks: commands that run at points in the agent’s work.
  • MCP integrations: connections to external tools and data.

Collaborative chats

In a shared cloud workspace, the chat’s creator can let everyone in the workspace message its agent. Click the Chat access button beside the chat tabs and choose Everyone in this workspace or Only you. Editors can then message the agent. Viewers and Commenters can read the chat but can’t send messages. The agent keeps its creator’s permissions, and the workspace owner pays for its usage. See Chats in shared workspaces.