Superconductor Docs

Ticket

A ticket describes a feature, bug fix, or refactor to implement in your project.

Ticket dashboard showing active tickets with status indicators and search functionality

A ticket describes a feature, bug fix, or refactor to implement in your project. Each ticket has:

  • Description: The task or feature to be implemented
  • Title: Automatically generated from the description
  • Status: Whether the ticket is completed or in progress
  • Implementations: One or more agent implementations working on the ticket

Creating tickets

Tickets can be created in several ways:

Attaching images, videos, and files

When creating a ticket from the app, you can attach images, videos, or documents to provide additional context for the agent. There are three ways to attach files:

  • Upload button: Click the "Attach images/files" button below the description field to browse and select files from your computer.
  • Drag and drop: Drag files directly into the ticket creation form.
  • Copy and paste: Copy an image to your clipboard and paste it into the form.

Supported file types include common image formats (PNG, JPEG, GIF, SVG, WebP, and more), video formats (MP4, MOV, WebM, AVI, MPEG, WMV, FLV, and 3GP), as well as PDFs and text-based files. Images can be up to 10 MB, documents up to 25 MB, and videos up to 100 MB.

Changing branches

By default, agents working on your ticket will use the default branch (e.g., main) for each repository linked to the project. If you want agents to work from a different branch, you can change this when creating a ticket.

For projects with a single repository, a branch selector appears in the ticket creation form. For projects with multiple repositories, expand the "Change branches..." section to see a branch selector for each repository. Use the search field within the selector to find branches by name.

Ticket dashboard

Ticket dashboard showing active tickets with filter tabs and search

When you click into a project, you'll see your ticket dashboard—a list of all tickets in that project.

Starring tickets

Starred tickets shown at the top of the ticket list

Click the star icon on any ticket to mark it as important and move it to the top of the ticket list. Starred tickets are a quick way to bookmark the ones you want to keep an eye on.

Filtering tickets

Filter tabs showing Active, Completed, and My Tickets options

Use the tabs at the top right to filter your view:

  • Active: Tickets that are still in progress
  • Completed: Tickets that are done (auto-marked when the linked PR is merged)
  • My Tickets: Tickets you created or that were created from a Slack or GitHub conversation you were involved in

You can also use the search bar to find tickets by title or description.

Ticket cards

A ticket card showing the title, creation info, and status badge

Each ticket card shows:

  • Status indicator: A badge showing the current state of the ticket's implementations
  • Creation info: When the ticket was created and who created it
  • GitHub tag: If a PR has been created, you'll see a tag linking to it

Implementation statuses

StatusDescription
RunningAt least one implementation is currently running
X waitingX implementations are waiting for user input
X runningX implementations are actively working

GitHub tag colors

When a ticket has an associated PR, you'll see a colored GitHub tag:

ColorMeaning
BluePR is open
GreenPR has been merged
RedPR was closed without merging
GrayPR is a draft

Implementations

Each ticket can have multiple implementations running in parallel. This allows you to compare different agents or approaches side by side. See Implementation for more details on working with implementations.

On this page