Superconductor Docs

Chats

Start a conversation with an agent that can access your project's repos, without creating a ticket.

Project page with the Chats, Benchmark, Automations, and Settings links, and the composer switched to Chat mode with a Start Chat button

A chat is a conversation with an agent that can access your project's repos. Use it when you want to talk to an agent without changing code: ask a question about the codebase, dig through your team's docs and tickets, start a research task, or create a one-off report.

This page is about chats in a project. For the chat with the coding agent inside a ticket implementation, see Chat.

Chats and tickets differ in intent, and the agent behaves differently in each.

TicketChat
What it's forWork you want shippedQuestions, exploration, research
The agentWrites code and opens a pull requestReads the code and answers you
BranchYou pick the base branchAlways each repo's default branch
ResultA branch, a diff, a live preview, and a PRAnswers and artifacts

Everything else is the same: the same agents, the same cloud sandbox, the same skills, MCP servers, and network rules from your project.

Starting a chat

Composer in Chat mode with a question typed, the Ticket and Chat toggle, the attach and drafts buttons, and the Opus 5 agent selector

Chats start in the same form you use to create tickets. Flip the toggle from Ticket to Chat, write your message, and click Start Chat.

You can do this in three places:

  • A project's Chats page — click Chats in the project header. The chat lands in that project.
  • Workspace dashboard — use the composer at the top of your Projects page and pick the project from the dropdown menu.
  • Sidebar — click New in the sidebar from anywhere in the app, then pick the project. In the desktop app, Cmd/Ctrl+N does the same thing.

A few things work differently from a ticket:

  • An agent is required. Tickets can be created without one; chats can't, so Start Chat stays disabled until you pick one. The form starts with one run of your Default agent profile, or the best available agent if you haven't set one.
  • There's no branch selector. Agents in a chat always get each repository's default branch, so the branch controls disappear in Chat mode.
  • There's no title field. Superconductor writes the title for you from your first message.

Attachments and drafts work exactly as they do for tickets. See Attaching images, videos, and files and Drafts.

Asking several agents at once

Use the 1x agent selector to start the same chat with up to 12 agents at once. Each one gets its own sandbox and its own conversation, and they all share the generated title.

This is the fastest way to compare agents on a real question from your codebase — ask two or three of them "how does our billing code handle refunds?" and read the answers side by side.

Your project's chats

Chats page showing the composer above a searchable list of chats, each with a creator, agent, and status badge

Click Chats in the project header to see every chat in the project. The list updates live as agents work.

Each card shows the chat's title, who started it, which agent and model it's running, when it was last active, and its status:

StatusWhat it means
IdleThe agent isn't working. It's waiting for your next message.
RunningThe agent is working right now.
WaitingThe agent needs something from you before it can continue.
FailedSomething went wrong during the run.

Use the search box to find a chat by its title or by who started it, or click My Chats to narrow the list to your own.

Inside a chat

A chat page has two panes: the chat itself and a review pane holding your artifacts. Use the Chat and Review toggles in the header to show or hide either one. On a phone, they become tabs.

Everything you can do in an implementation's chat works here too, including:

The Artifacts tab in the review pane collects every screenshot, diagram, document, and data file the agent saves during the chat. See Artifacts for what agents can produce and how to view it.

Some ticket features don't apply to a chat, because there's no branch to work on: no diff or Guided Review, no live preview or terminal, no pull requests, and no shell mode (typing ! in the message box).

What the agent can and can't do

Each chat gets its own cloud sandbox. Superconductor clones your project's repos into it on their default branches, and the agent gets everything else your project provides:

The agent is told not to modify code, run tests, or open pull requests. Nothing it does in a chat is pushed anywhere, and there's nothing to merge afterward. If the conversation turns into implementation work, the agent will say so and suggest you create a ticket — it can help you explore the idea or draft the ticket first.

Ask for artifacts when you want something you can keep — "draw me a diagram of how auth works" or "save the results as a CSV."

Following and notifications

You automatically follow a chat when you start one or send a message in it. Followed chats appear in your Recent Activity sidebar alongside implementations, and you'll get push notifications when the agent replies.

Use the Follow button in the chat header to follow or unfollow a chat a teammate started. On a desktop-width screen, you can also hover a chat in the sidebar to reveal a menu with Unfollow and Delete. Deleting asks you to confirm first, and removes the chat for everyone in the workspace.

Who can see and start chats

Chats are shared with your whole workspace, the same as tickets and implementations — they aren't private to whoever started them.

RoleCan do
Owner, Admin, CollaboratorStart chats and send messages
ViewerRead chats

See Member roles for more on roles and permissions.

What a chat costs

A chat costs the same way an implementation does: tokens for the agent and sandbox hours for the cloud instance it runs on. See Pricing for how both are billed, and the Usage dashboard for what your workspace is spending.

Tips

Ask about the codebase, not just about code

"Where do we handle Stripe webhooks, and what happens when one fails?" is a better chat than a search. The agent can read every repo in the project and follow the trail for you.

Use it as a research agent

Chats aren't only for engineers. Once you've connected your team's tools, an agent can read your Notion pages, Linear tickets, and meeting notes and answer a question that spans all of them: "what did we promise this customer across the last three calls, and what's still open?"

Ask for a deliverable

Agents can produce diagrams, reports, and spreadsheets as artifacts. Say what you want and how you want it: "compare these three vendor quotes and give me a spreadsheet with the totals by department," or "write this up as a Markdown doc I can share."

Turn the answer into a ticket

When a chat turns into work you actually want done, create a ticket, attach any artifacts from the chat, and paste in what you learned. If it helps, ask the chat agent for a .md artifact summarizing the chat, and share that with the coding agent on the ticket. Chats and tickets are separate — a chat never becomes a ticket on its own.

Next steps

On this page