> ## 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.

# Model Selection

> Choose and configure models for each agent

PuzldAI lets you pick specific models for each agent. Use aliases like `sonnet`, `opus`, `haiku` or full model names.

## Quick Commands

### TUI

```bash theme={null}
/model                     # Open model selection panel
/model claude opus         # Set Claude to Opus
/model gemini flash        # Set Gemini to Flash
/model ollama llama3.2     # Set Ollama model
```

### CLI

```bash theme={null}
puzldai model show              # Show current models
puzldai model list              # List all available models
puzldai model list claude       # List models for specific agent
puzldai model set claude opus   # Set model for an agent
puzldai model clear claude      # Reset to CLI default
```

## Per-Task Override

Override the model for a single task without changing settings:

```bash theme={null}
puzldai run "task" -m opus              # Use Opus for this task
puzldai run "task" -a claude -m haiku   # Use Claude with Haiku
puzldai agent -a claude -m opus         # Interactive mode with Opus
```

## Available Models

### Claude

| Alias | Full Model Names |
| - | - |
| `opus` | claude-opus-4-20250514, claude-opus-4-5-20251101 |
| `sonnet` | claude-sonnet-4-20250514, claude-sonnet-4-5-20250929 |
| `haiku` | claude-haiku-4-5 |

### Gemini

| Alias | Full Model Names |
| - | - |
| `pro` | gemini-2.5-pro, gemini-3-pro-preview |
| `flash` | gemini-2.5-flash |
| `flash-lite` | gemini-2.5-flash-lite |

### Codex

| Model |
| - |
| gpt-5.1-codex-max |
| gpt-5.1-codex |
| gpt-5.1-codex-mini |
| gpt-5.1 |

### Mistral

| Alias | Full Model Names |
| - | - |
| `devstral-2` | mistral-vibe-cli-latest |
| `devstral-small` | devstral-small-latest |

### Ollama

Any model installed locally:

```bash theme={null}
ollama list                    # See installed models
/model ollama llama3.2         # Use specific model
/model ollama deepseek-r1      # Use DeepSeek
```

## Model Selection Panel

The `/model` command opens an interactive panel:

* Browse available models per agent
* See which model is currently active
* Quick-switch between models

## Best Practices

| Use Case | Recommended |
| - | - |
| Complex reasoning | `opus`, `pro` |
| Fast responses | `haiku`, `flash` |
| Code generation | `sonnet`, `flash` |
| Local/private | `ollama` |
| Cost-conscious | `haiku`, `ollama` |


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