Subagents launched via task tool ignore their model: frontmatter and inherit parent agent's model #35126

Activity

1. github-actions

   assigned

   jlongster

   on Jul 3, 2026
2. github-actions commented on Jul 3, 2026

   

   github-actionsBot

   on Jul 3, 2026 – with GitHub Actions

   Contributor

   More actions

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

   • [Bug] Subagent spawned via Task tool uses global config model instead of inheriting parent session's active model #17870: Subagent spawned via Task tool uses global config model instead of inheriting parent session's active model — same core symptom (subagents not using the model they should when invoked via the task tool)
   • subagent model variants are parsed but not applied at runtime in v1.4.0 #21632: subagent model variants are parsed but not applied at runtime in v1.4.0 — subagent model config is correctly parsed/resolved in debug output but not honored at runtime during task invocation
   • [Bug] Model parameter ignored when launching subagent with agent name #18615: Model parameter ignored when launching subagent with agent name — model specified for a subagent is overridden by a fallback chain when an agent name is also provided
3. opencode-agent commented on Jul 9, 2026

   

   opencode-agentBot

   on Jul 9, 2026 – with OpenCode Agent

   Contributor

   More actions

   Automated maintainer triage by OpenCode Agent.

   I tried to reproduce this on current dev (b8374b5a7c5, 2026-07-09) and could not reproduce it.

   Exact reproduction I used:

   1. Ran OpenCode from a fresh origin/dev worktree with an isolated HOME/XDG config and a writable SQLite DB.

   2. Registered a fake OpenAI-compatible provider test with two available models:

      • test/test-model — parent/default model
      • test/cheap-model — subagent model

   3. Created the markdown subagent at ~/.config/opencode/agents/test-agent.md:

      ---
      description: Test agent
      mode: subagent
      model: test/cheap-model
      ---
      Return "hello" and nothing else.

   4. Started a parent run on test/test-model and had the model call the task tool with:

      {
        "description": "inspect bug",
        "prompt": "say hello",
        "subagent_type": "test-agent"
      }

   5. Queried the session database afterward:

      SELECT agent, model FROM session ORDER BY time_created DESC LIMIT 5;

   Observed child session row:

   {
     "agent": "test-agent",
     "model": {"id":"cheap-model","providerID":"test","variant":"default"}
   }

   So on current dev, the subagent markdown model: frontmatter is parsed and honored through the task tool; it did not inherit the parent model.

   The most likely cause for reports that still look like this is that the configured model string is not resolving to a model available to that user/provider installation. Please run:

   opencode models
   # or
   opencode models <provider>

   and make sure the agent frontmatter uses the exact provider/model string shown there. This matters especially for custom OpenAI-compatible providers and model aliases.

   Closing as not reproducible on current dev. If this still happens on a current build, please open a fresh issue with:

   • exact opencode --version
   • sanitized provider config
   • opencode models / opencode models <provider> output for the relevant provider
   • the exact ~/.config/opencode/agents/<agent>.md frontmatter
   • the resulting SELECT agent, model FROM session ... row
4. opencode-agent

   closed this as not plannedon Jul 9, 2026