Repository navigation
[FEATURE]: Add --variant flag to root opencode command #7354
Description
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
The --variant flag was added to opencode run in #6805 but is missing from the root opencode command.
Current Behavior
# Works
opencode run --model anthropic/claude-sonnet-4-20250514 --variant max "hello"
# Doesn't work - variant flag not recognized
opencode --model anthropic/claude-sonnet-4-20250514 --variant max --prompt "hello"Expected Behavior
Both commands should support --variant.
This matters most when --prompt is provided since the model responds immediately - users can't control reasoning effort for that initial response.
Relevant Files
| File | Current State |
|---|---|
src/cli/cmd/run.ts:90-93 |
Has --variant option |
src/cli/cmd/tui/thread.ts |
Missing --variant option |
src/cli/cmd/tui/context/args.tsx |
Args interface lacks variant |
Implementation Notes
The variant infrastructure already exists in the TUI. Changes needed:
thread.ts: Add--variantoption to yargs builderargs.tsx: Addvariant?: stringtoArgsinterfacethread.ts: Passvariantthrough totui()argslocal.tsx: Initialize variant from CLI arg (similar to howargs.modelis handled at line 142)
The variant management (model.variant.set(), model.variant.current(), etc.) is already implemented in local.tsx:310-347, so this is just a CLI argument threading task.
Activity
github-actions commentedon Jan 8, 2026
This issue relates to #7138 which implements default variant configuration per agent. While this issue (#7354) focuses on adding the
--variantCLI flag to the root command, #7138 adds per-agent default variants in the config. Both approaches are complementary:buildagent always useshighvariant)--variantflag to rootopencodecommand #7354: Override via CLI flag (e.g.,opencode --variant max --prompt ...)These work together to give users flexible variant control at both the configuration and CLI levels.
ekweible commentedon Jan 8, 2026
This one seemed fairly straightforward and given that
opencode runalready supports it, I assumed it would be reasonable to have on the root command, too, so I opened a PR here: #7358Feel free to close if that's not the case!
gjermundgaraba commentedon Jan 16, 2026
Just to add to this, would like to see this added.
For context, I use the root opencode command to quickly spin up a code review with a script that creates a worktree for a PR's branch and launches opencode with a prompt (using a custom slash command). The reason I want variant is becuase I want to use
maxfor claude andxhighfor codex (I usually like to run one with each).I am using a fork locally for this, right now, but would love to get this functionality upstreamed. I'll link my fork's commit in the PR, in case there is anything useful there :)
github-actions commentedon Mar 26, 2026
To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.
zclllyybb commentedon Apr 10, 2026
Meaningful feature, are there still people following up on it now?
fix(oc): drop unsupported --variant from default opencode launch temp…
Starefossen commentedon Oct 1, 2026
Still affects OpenCode 1.18.34:
opencode --model github-copilot/gpt-6-sol --variant lowprints root help and exits 1.opencode run --variant lowworks, but does not start the TUI. This blocks nav-pilot from forwarding its configured reasoning effort to interactive sessions. PR #7358 remains open.