sim/apps/docs/content/docs/en/copilot/index.mdx

---
title: Copilot
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Card, Cards } from 'fumadocs-ui/components/card'
import { Image } from '@/components/ui/image'
import { MessageCircle, Hammer, Zap, Globe, Paperclip, History, RotateCcw, Brain } from 'lucide-react'

Copilot is your in-editor assistant that helps you build and edit workflows. It can:

- **Explain**: Answer questions about Sim and your current workflow
- **Guide**: Suggest edits and best practices
- **Build**: Add blocks, wire connections, and configure settings
- **Debug**: Analyze execution issues and optimize performance

<Callout type="info">
  Copilot is a Sim-managed service. For self-hosted deployments:
  1. Go to [sim.ai](https://sim.ai) → Settings → Copilot and generate a Copilot API key
  2. Set `COPILOT_API_KEY` in your self-hosted environment
</Callout>

## Modes

Switch between modes using the mode selector at the bottom of the input area.

<Cards>
  <Card
    title={
      <span className="inline-flex items-center gap-2">
        <MessageCircle className="h-4 w-4 text-muted-foreground" />
        Ask
      </span>
    }
  >
    <div className="m-0 text-sm">
      Q&A mode for explanations, guidance, and suggestions without making changes to your workflow.
    </div>
  </Card>
  <Card
    title={
      <span className="inline-flex items-center gap-2">
        <Hammer className="h-4 w-4 text-muted-foreground" />
        Build
      </span>
    }
  >
    <div className="m-0 text-sm">
      Workflow building mode. Copilot can add blocks, wire connections, edit configurations, and debug issues.
    </div>
  </Card>
</Cards>

## Models

Select your preferred AI model using the model selector at the bottom right of the input area.

**Available Models:**
- Claude 4.5 Opus, Sonnet (default), Haiku
- GPT 5.2 Codex, Pro
- Gemini 3 Pro

Choose based on your needs: faster models for simple tasks, more capable models for complex workflows.

## Context Menu (@)

Use the `@` symbol to reference resources and give Copilot more context:

| Reference | Description |
|-----------|-------------|
| **Chats** | Previous copilot conversations |
| **Workflows** | Any workflow in your workspace |
| **Workflow Blocks** | Blocks in the current workflow |
| **Blocks** | Block types and templates |
| **Knowledge** | Uploaded documents and knowledge bases |
| **Docs** | Sim documentation |
| **Templates** | Workflow templates |
| **Logs** | Execution logs and results |

Type `@` in the input field to open the context menu, then search or browse to find what you need.

## Slash Commands (/)

Use slash commands for quick actions:

| Command | Description |
|---------|-------------|
| `/fast` | Fast mode execution |
| `/research` | Research and exploration mode |
| `/actions` | Execute agent actions |

**Web Commands:**

| Command | Description |
|---------|-------------|
| `/search` | Search the web |
| `/read` | Read a specific URL |
| `/scrape` | Scrape web page content |
| `/crawl` | Crawl multiple pages |

Type `/` in the input field to see available commands.

## Chat Management

### Starting a New Chat

Click the **+** button in the Copilot header to start a fresh conversation.

### Chat History

Click **History** to view previous conversations grouped by date. You can:
- Click a chat to resume it
- Delete chats you no longer need

### Editing Messages

Hover over any of your messages and click **Edit** to modify and resend it. This is useful for refining your prompts.

### Message Queue

If you send a message while Copilot is still responding, it gets queued. You can:
- View queued messages in the expandable queue panel
- Send a queued message immediately (aborts current response)
- Remove messages from the queue

## File Attachments

Click the attachment icon to upload files with your message. Supported file types include:
- Images (preview thumbnails shown)
- PDFs
- Text files, JSON, XML
- Other document formats

Files are displayed as clickable thumbnails that open in a new tab.

## Checkpoints & Changes

When Copilot makes changes to your workflow, it saves checkpoints so you can revert if needed.

### Viewing Checkpoints

Hover over a Copilot message and click the checkpoints icon to see saved workflow states for that message.

### Reverting Changes

Click **Revert** on any checkpoint to restore your workflow to that state. A confirmation dialog will warn that this action cannot be undone.

### Accepting Changes

When Copilot proposes changes, you can:
- **Accept**: Apply the proposed changes (`Mod+Shift+Enter`)
- **Reject**: Dismiss the changes and keep your current workflow

## Thinking Blocks

For complex requests, Copilot may show its reasoning process in expandable thinking blocks:

- Blocks auto-expand while Copilot is thinking
- Click to manually expand/collapse
- Shows duration of the thinking process
- Helps you understand how Copilot arrived at its solution

## Options Selection

When Copilot presents multiple options, you can select using:

| Control | Action |
|---------|--------|
| **1-9** | Select option by number |
| **Arrow Up/Down** | Navigate between options |
| **Enter** | Select highlighted option |

Selected options are highlighted; unselected options appear struck through.

## Keyboard Shortcuts

| Shortcut | Action |
|----------|--------|
| `@` | Open context menu |
| `/` | Open slash commands |
| `Arrow Up/Down` | Navigate menu items |
| `Enter` | Select menu item |
| `Esc` | Close menus |
| `Mod+Shift+Enter` | Accept Copilot changes |

## Usage Limits

Copilot usage is billed per token from the underlying LLM. If you reach your usage limit, Copilot will prompt you to increase your limit. You can add usage in increments ($50, $100) from your current base.

<Callout type="info">
  See the [Cost Calculation page](/execution/costs) for billing details.
</Callout>