[FEATURE]: Commands Model Variant Specification

Feature hasn't been suggested before.

I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

I'm willing to implement this, but since it involves some design decisions, I wanted to open an issue first.

Summary

Add a variant field to the commands feature. Currently, command definitions in command/*.md or opencode.json(c) only allow selecting the model or agent, but not the model variant.

Motivation

While variants can be applied globally or per-agent, it is useful to bake specific reasoning efforts into commands. For example, a command designed for complex planning or code review might always want to use a high thinking variant of a lightweight model, even if the user's global preference is set to minimal. This ensures specific tasks have the reasoning budget they need without requiring the user to manually switch variants before running the command.

The precedence has been reconsidered. Check #7907

Proposed Priority

If implemented, I suggest the following priority for variant resolution:

Explicit runtime selection (CLI --variant flag or TUI ctrl+t)

Command definition variant (The new field)

Agent default variant (as implemented in Add default variant config per agent #7140)

None (Model default)

This feature request is related to several existing issues that address variant and model configuration:

[FEATURE] Support default variant configuration per agent (#7156) #7138: Support default variant configuration per agent - Implements agent-level variant defaults, which is part of the variant resolution priority chain mentioned in this issue
[FEATURE]: Add --variant flag to root opencode command #7354: Add --variant flag to root opencode command - Related to variant handling via CLI
[FEATURE]: allow shell commands in the frontmatter #5082: Allow shell commands in the frontmatter - Related request for dynamic configuration in command definitions
Server API ignores agent's configured model when only agent parameter is passed #7099: Server API ignores agent's configured model when only agent parameter is passed - Related to model/agent configuration propagation
[FEATURE]: Allow skills and commands to define scoped permission overrides #7407: Allow skills and commands to define scoped permission overrides - Shows precedent for adding configuration fields to command frontmatter

You may want to cross-reference these issues, particularly #7138 which implements the agent-level variant configuration that would complement your proposed command-level variant specification.

@koichincom Nakayamada-san, this is similar to what I was interested in with my issue #7138 / pr #7156 for variant support in agents - try taking a look and see if maybe commands can be extended similarly :P

@CasualDeveloper

@koichincom Nakayamada-san, this is similar to what I was interested in with my issue #7138 / pr #7156 for variant support in agents - try taking a look and see if maybe commands can be extended similarly :P

@CasualDeveloper Thanks! I'll look into it and probably make a PR for the commands feature!

To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.

Navigation Menu

Repository navigation

[FEATURE]: Commands Model Variant Specification #7713

Feature hasn't been suggested before.

Describe the enhancement you want to request

Summary

Motivation

Proposed Priority

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[FEATURE]: Commands Model Variant Specification #7713

Description

Feature hasn't been suggested before.

Describe the enhancement you want to request

Summary

Motivation

Proposed Priority

Activity

github-actions commented on Jan 10, 2026

CasualDeveloper commented on Jan 11, 2026

koichiio commented on Jan 11, 2026

thdxr commented on Mar 25, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions