Model Reference
This page lists recommended models for AgentUse, organized by provider.Note: Other models from these providers may also work. These are the ones we recommend and test against.
Auto-generated: Run pnpm generate:models to update.
Quick Reference
Default models:- Anthropic:
anthropic:claude-sonnet-5-5(balanced performance) - OpenAI:
openai:gpt-5.6(general-purpose GPT) - OpenRouter:
openrouter:z-ai/glm-5.3(open source) - OpenCode Go:
opencode-go:gpt-6-luna(open coding models) - Amazon Bedrock:
bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0
Version Aliases
Leave the version off a model id and you get whichever release is current, so an agent file does not need editing every time a new model ships:
Run
agentuse models to see what each alias resolves to on your install, and
agentuse models unpin to convert pinned ids in your agent files into aliases.
To name your own, add a models.aliases block to ~/.agentuse/config.json and
reference it with the @ sigil (see Configuration Files):
reasoning, the same field as
agent frontmatter, and give each fallback its own setting:
model: "@deep". A candidate’s explicit reasoning takes
precedence over agent frontmatter. Candidates without a preset use the agent’s
reasoning setting, or the model default when that is omitted. Effort is never
inherited from the previous candidate. Existing model-specific reasoning
compatibility rules still apply.
Presets support none, minimal, low, medium, high, xhigh, and max.
agentuse models shows configured effort alongside each resolved candidate.
The resolved settings are captured with the session for approval resume and
with run-wide model overrides. If a preset references another fallback alias,
its reasoning override applies only to that alias’s primary candidate. Repeating
a concrete model with conflicting reasoning settings is a configuration error.
Named aliases may also define ordered fallback candidates and an in-memory
cooldown. See Model defaults and aliases.
Recommended Models
Anthropic
OpenAI
OpenRouter
OpenCode Go
Amazon Bedrock
Bedrock model IDs are passed through unchanged and are not validated against the static registry. Use any model ID supported by your AWS account and region.
See the Amazon Bedrock model catalog for the full list. Model availability depends on the AWS region and on the model access granted in your account.
Authentication uses standard AWS environment variables (
AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_REGION, optional AWS_SESSION_TOKEN) or AWS_BEARER_TOKEN_BEDROCK. See the Model Configuration guide for details.
Custom Providers
In addition to the built-in providers above, Dashboard Settings can connect custom OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages endpoints. It discovers and saves available models and verifies the selected protocol with a minimal completion. For OpenAI-compatible local endpoints, you can also use the CLI:Usage
Specify a model in your agent file, pinned to a version or tracking the line:model entirely to use the configured default (models.default or
AGENTUSE_MODEL).
Or override via CLI, which accepts the same aliases: