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

# Compare Mode

> Run prompts on multiple models and compare responses

Compare mode sends the same prompt to multiple AI models simultaneously and displays their responses side-by-side for easy comparison.

## Usage

### TUI (Interactive)

```bash theme={null}
/compare <agents> "<prompt>"
/sequential      # toggle sequential execution
/pick            # toggle LLM picks best
```

### CLI

```bash theme={null}
puzldai compare "<prompt>" -a <agents> [-s] [-p]
```

| Flag | Description |
| - | - |
| `-a` | Comma-separated agents to compare |
| `-s` | Run sequentially instead of parallel |
| `-p` | Have an LLM pick the best response |

### Examples

```bash theme={null}
# TUI: Compare Claude and Gemini
/compare claude,gemini "Explain microservices architecture"

# CLI: Compare three models with pick mode
puzldai compare "Write a binary search function" -a claude,gemini,ollama -p
```

## Features

### Side-by-Side View

Responses are displayed in columns, allowing you to easily compare:

* Response quality and completeness
* Different approaches to the same problem
* Response time for each model

### Sequential Mode

By default, all models run in parallel. Enable sequential mode to run one at a time:

```bash theme={null}
/sequential    # Toggle sequential mode
```

This is useful when you want to see responses as they complete.

### Pick Mode

Enable pick mode to have an AI select the best response:

```bash theme={null}
/pick          # Toggle pick mode
```

When enabled, after all responses are collected, an AI evaluates them and selects the best one with an explanation.

## Project Context

Compare mode automatically injects project structure context, so models understand your codebase without needing file access.

## Keyboard Shortcuts

| Key | Action |
| - | - |
| `Escape` | Hide view (keeps running in background) |
| `Ctrl+E` | Return to compare view |
| `Ctrl+C` | Cancel all requests |
| `←/→` | Navigate between responses |

## History

After exiting compare mode, results are saved as a compact view in chat history. Press **Ctrl+E** to expand and view again.

## Options

| Option | Command | Description |
| - | - | - |
| Sequential | `/sequential` | Run models one at a time |
| Pick | `/pick` | Auto-select best response |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.