commands: unresolvable model in frontmatter silently drops the command #52065

Activity

1. github-actions

   assigned

   jlongster

   on Sep 29, 2026
2. github-actions commented on Sep 29, 2026

   

   github-actionsBot

   on Sep 29, 2026 – with GitHub Actions

   Contributor

   More actions

   This issue might be a duplicate of existing issues. Please check:

   • core: legacy Markdown agent silently drops "model: provider/model#variant" — subagent inherits parent model #50849: A similar silent model-frontmatter drop is reported for Markdown agents using a model ref with an inline variant, including command model refs in its described scope.
3. 51smith commented on Sep 29, 2026

   

   51smith

   on Sep 29, 2026

   Author

   More actions

   Checked #50849 — same symptom family (silent model-frontmatter drop), but a distinct failure mode:

   • core: legacy Markdown agent silently drops "model: provider/model#variant" — subagent inherits parent model #50849: Markdown agents carrying a legacy v1 key (e.g. permission:) route through the migration path, where a valid provider/model#variant ref is discarded — the agent still loads, it just inherits the parent's model (fix in fix(core): parse embedded "#variant" in model selections #50853).
   • This issue: commands on the native path — a bare unresolvable model: value (opus, not provider/model) drops the whole command from autocomplete, with nothing logged at INFO or DEBUG. No legacy keys involved; the repro frontmatter is just description + model.

   Different artifact, different code path, different blast radius — keeping this open for the command case.
4. opencodejr commented on Oct 28, 2026

   

   opencodejrBot

   on Oct 28, 2026

   More actions

   Thanks for the clear report. I could reproduce this on v2.0.19, and it still happens on the latest dev (86ce19d).

   Setup: two otherwise identical project commands in .opencode/commands/. hello-bad.md has model: opus in its frontmatter and hello-ok.md has no model line. Typing /hello in the TUI lists only /hello-ok. The recording and screenshots below show this, and the script below reproduces it.

   The cause seems to be that the command loader checks all the frontmatter at once. When the model value isn't a provider/model reference, the whole file fails and is skipped without a log message. Until this is changed, using a full provider/model value or removing the model: line works around it.

   Related:

   • fix(core): keep commands whose model is not provider/model #52195: open PR that targets this issue (warns and ignores the invalid model instead of dropping the command)
   • agent: frontmatter description starting with '[' silently drops the agent (AgentNotFoundError) #54200: the same kind of silent drop for agents, caused by a different frontmatter value

   recording.mp4

   

   

   Reproduction script (drive.ts)

   // Repro for #52065: a command whose frontmatter `model:` is not provider/model
   // (e.g. `model: opus`) is silently missing from `/` autocomplete.
   import { Effect } from "effect"
   import { OpenCodeDriver } from "opencode-drive"
   
   export default OpenCodeDriver.use(
     {
       ...(process.env.OC_DEV ? { opencode: { dev: process.env.OC_DEV } } : {}),
       tui: { recording: true, keypressOverlay: true },
       project: {
         git: true,
         files: {
           // Same command, but with a bare model name: expected to load, is dropped.
           ".opencode/commands/hello-bad.md":
             "---\ndescription: says hello (model: opus)\nmodel: opus\n---\n\nSay hello: $ARGUMENTS\n",
           // Control: identical command without the model line: loads fine.
           ".opencode/commands/hello-ok.md":
             "---\ndescription: says hello (no model)\n---\n\nSay hello: $ARGUMENTS\n",
         },
       },
     },
     ({ ui }) =>
       Effect.gen(function* () {
         yield* Effect.sleep(1500)
         yield* ui.type("/hello")
         yield* ui.waitFor("says hello (no model)")
         yield* Effect.sleep(1500)
         const frame = yield* ui.capture()
         const text = JSON.stringify(frame)
         yield* ui.screenshot("autocomplete")
         const bad = text.includes("hello-bad")
         yield* Effect.log(`hello-ok listed: ${text.includes("hello-ok")}; hello-bad listed: ${bad}`)
         if (!bad) yield* Effect.log("REPRODUCED: command with `model: opus` is missing from / autocomplete")
       }),
   )

   Run it with opencode-drive: opencode-drive run ./drive.ts. It drives opencode from your PATH; set OC_DEV to the path of an OpenCode checkout to run that from source instead.
5. opencodejr

   added

   reproduced

   on Oct 28, 2026
6. Tarquinen

   closed this as completedin #62251on Nov 7, 2026