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

/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

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:

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:

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