> ## Documentation Index
> Fetch the complete documentation index at: https://commander-docs.cyshel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Workflows

> Step-by-step guides for common Commander workflows.

## Starting a Feature from Linear

<Steps>
  <Step title="Search for an issue">
    Press `Cmd+K`, type `#`, and search for the Linear issue you want to work on.
  </Step>

  <Step title="Create workspace">
    Select the issue and click **Create Workspace**. Commander creates an isolated git worktree and
    links it to the issue.
  </Step>

  <Step title="Setup runs automatically">
    Your configured setup scripts (e.g., `pnpm install`) run in the new worktree.
  </Step>

  <Step title="Agent starts working">
    The agent begins with full context from the Linear issue — title, description, labels, and
    priority.
  </Step>

  <Step title="PR auto-links">
    When the agent creates a pull request, it's automatically linked to the Linear issue.
  </Step>
</Steps>

## Reviewing PR Feedback

<Steps>
  <Step title="Open the workspace">
    Click the notification or navigate to the workspace linked to the PR.
  </Step>

  <Step title="View comments">
    PR review comments appear in the right sidebar with file paths and line numbers.
  </Step>

  <Step title="Auto-resolve (optional)">
    If **Auto-Resolve PR Comments** is enabled, an agent automatically addresses each comment and
    pushes changes.
  </Step>

  <Step title="Manual resolution">
    Otherwise, send the agent a message like "Address the PR review comments" and it will work
    through them.
  </Step>
</Steps>

## Morning Standup with the Manager

<Steps>
  <Step title="Open Manager view">Press `Cmd+2` to open the Manager view.</Step>

  <Step title="Ask for a summary">
    Type "What happened overnight?" or "Give me a status update." The manager summarizes all
    workspace activity.
  </Step>

  <Step title="Review suggested actions">
    The manager suggests next steps as clickable buttons — like "Resume paused agents" or "Start
    next priority issue."
  </Step>

  <Step title="Take action">
    Click suggestions or give the manager instructions like "Start a workspace for the top-priority
    bug."
  </Step>
</Steps>

## Running Multiple Agents on One Task

<Steps>
  <Step title="Create a workspace">Create a workspace for the feature you're building.</Step>

  <Step title="Start the first agent">
    Send the first agent a focused prompt, e.g., "Implement the database schema and migrations."
  </Step>

  <Step title="Add more agents">
    Start additional agents in the same workspace with different focuses: "Write the API endpoints",
    "Add unit tests."
  </Step>

  <Step title="Monitor in parallel">
    Switch between agent tabs to monitor progress. Each agent works in the same worktree but on
    different files.
  </Step>

  <Step title="Resolve any conflicts">
    If agents modify the same files, review the changes in the diff viewer and resolve conflicts.
  </Step>
</Steps>

## Auto-Fixing CI Failures

<Steps>
  <Step title="Enable auto-fix">
    In repository settings, toggle **Auto-Fix CI** and set a max retry count.
  </Step>

  <Step title="CI fails on a linked PR">
    When CI checks fail on a workspace's linked pull request, Commander detects it automatically.
  </Step>

  <Step title="Agent analyzes logs">
    An agent examines the CI failure logs to understand what went wrong.
  </Step>

  <Step title="Fix and push">The agent makes the necessary changes and pushes a new commit.</Step>

  <Step title="Retry limit">
    If the fix doesn't work, the agent retries up to your configured limit (default: 3 attempts).
  </Step>
</Steps>