Superconductor Docs

Implementation

Each implementation represents an AI agent working on a ticket, with chat, live preview, and code review capabilities.

Implementation view showing chat, live preview, and code review panels

An implementation is an AI agent working on a ticket. Each ticket can have multiple implementations running in parallel, letting you compare different agents or approaches side by side.

Launching implementations

You can launch implementations in two ways:

When creating a ticket: Select one or more agents from the Select Profiles dropdown before submitting your ticket. The implementations will start automatically.

Select Profiles dropdown showing available agents when creating a ticket

From an existing ticket: Click the + Launch button in the ticket's Implementations section to add another agent to work on the same task.

How many agents can I run at once? As many as you like! Each implementation gets its own isolated workspace to prevent conflicts. Run multiple agents in parallel to compare approaches or speed up your workflow.

Not seeing an agent you want? Check that you have the required API key or connected plan configured. See Agent credentials for setup details, and Agents for the full list of supported agents.

Usage stats

Profile selector showing usage stats with 5-hour and 7-day rate limit utilization for Claude Code and Codex

If you've connected your Claude Pro/Max plan or ChatGPT Pro plan via OAuth, Superconductor displays your rate limit utilization next to the agent name. You'll see two numbers:

  • 5h — Percentage of your 5-hour rolling window rate limit consumed
  • 7d — Percentage of your 7-day rolling window rate limit consumed

A rolling window means the limit tracks your usage over a continuous period ending at the current moment. For example, the 5-hour window counts all API usage from the last 5 hours — as older usage falls outside the window, your utilization drops.

The numbers are color-coded:

  • Green — Under 70% utilization
  • Yellow — 70–89% utilization
  • Red — 90% or above, approaching the limit

When utilization reaches 70% or higher, you'll also see a countdown showing when the window resets.

If utilization exceeds 100%, your plan's rate limit is fully consumed and implementations will stop until the window resets. Superconductor does not automatically fall back to an API key. You can either wait for the reset or disconnect your plan in account settings and use an API key instead. See Agent credentials for more details.

Usage stats only appear for Claude Code and Codex when using a connected plan (OAuth). They don't appear when using API keys, or for other agents.

The implementation dashboard

Ticket dashboard showing multiple implementations with status, messages, cost, and run time

Every ticket shows a dashboard of its implementations. Each implementation card displays:

  • Agent profile — The agent name and model (e.g., "Claude Code - Opus 4.6")
  • Messages — Number of messages in the conversation
  • Cost — Total API cost for the implementation
  • Run time — How long the agent has been working
  • Artifacts — Click to expand and view images and files the agent has shared (see Artifacts for details)
  • Status — Current state of the implementation

Implementation statuses

StatusWhat it means
RunningThe agent is actively working on the task
WaitingThe agent is waiting for your input before continuing
IdleThe agent has not begun running
FailedSomething went wrong — please let us know if you see this

Starring implementations

Click the star icon on any implementation to mark it as a favorite. You can star implementations from the ticket's implementation dashboard or from the implementation show page. Starred implementations help you quickly flag your favorite solutions when comparing multiple approaches.

Starred implementation showing star icon next to the agent name

Starring an implementation also automatically follows it, so you'll get updates in your Recent Activity sidebar.

Following implementations

Following button with bell icon on an implementation

Click the bell icon on any implementation to follow it. When you follow an implementation, you'll stay updated on its progress and it will appear in your Recent Activity sidebar.

Superconductor automatically follows implementations for you in these cases:

  • When you launch an implementation
  • When you send a message in an implementation's chat
  • When you star an implementation
  • When you're requested as a reviewer on the implementation's GitHub PR (requires a Superconductor account with a linked GitHub identity)

You can also trigger a follow by interacting with an implementation via Slack or GitHub.

To unfollow, click the bell icon again. Superconductor also automatically unfollows you from all of a ticket's implementations when the ticket is completed — for example, when all pull requests are merged.

Recent activity sidebar

Recent Activity sidebar showing implementations across the workspace

The Recent Activity sidebar shows all the implementations you're following, so you can keep track of everything you care about in one place. The most recent implementations you've interacted with are listed first.

Each entry shows:

  • Ticket title and project name
  • Agent model used (e.g., "Opus 4.6")
  • Diff stats — green and red badges showing lines added and removed
  • PR status — if a pull request has been created, colored badges show the PR state: green for open, purple for merged, red for closed, and gray for draft
  • Status — implementations that are currently running show an animated loading indicator so you can tell at a glance which agents are still working. Failed implementations show a warning icon, and completed ones show a relative timestamp (e.g., "5m", "2h ago").

Click any entry to jump straight to that implementation. The sidebar updates in real time as agents make progress.

The sidebar only shows activity from your current workspace. Switching workspaces gives you a separate activity feed.

Resizing and collapsing

On desktop, you can drag the sidebar edge to resize it, or double-click the edge to reset to the default width. Click the hamburger menu icon to collapse or expand the sidebar — your preference is remembered across sessions. On mobile, the sidebar is collapsed by default and can be opened from the menu.

Customizing implementation display

Toggle buttons for Chat, Preview, and Review sections

Within any implementation, use the toggle buttons to show or hide the three main sections: Chat, Preview, and Review.

Creating pull requests

Submit PR button

Want your agents to send commits to GitHub automatically? Enable Automatically commit and push branch in your project's Git Sync settings to have agents commit and push after every response — no manual step needed.

When you're happy with an implementation, click Submit PR to create a pull request on GitHub. Superconductor commits the agent's changes and opens a PR against your base branch. To learn more about interacting with agents from your pull request, see the GitHub integration docs.

If the agent makes more changes after you've submitted the PR (for example, after you ask it to fix something in chat), click Update PR to push the new changes. Each update creates a new commit on the existing PR—your review comments and CI status stay intact.

The button shows the current state:

ButtonWhat it means
Submit PRNo PR exists yet. Click to create one.
Update PRThe agent has made changes since you last pushed. Click to add a new commit to the existing PR.
View PRThe PR is up to date with the agent's latest changes. Click to open it on GitHub.

The icon on the View PR button changes color to reflect the pull request's status on GitHub:

OpenMerged
View PR button with green icon indicating an open PRView PR button with purple icon indicating a merged PR

You can also use the dropdown menu to copy the branch name or push the branch to GitHub without creating a PR (useful if you want to open the PR manually).

Branch naming

Branch names are generated from a customizable template. You can configure the pattern in your workspace's branch naming settings.

Multi-repo projects

If your project has multiple repos and the agent makes changes across more than one, Superconductor creates a separate PR for each repo. The button labels update automatically — Submit PRs, Update PRs, and View PRs — and a dropdown lets you view each PR individually by repo name and number.

Next steps

On this page