Update opencode.json schema ? #3022

Closed
opened 2026-02-16 17:38:16 -05:00 by yindo · 1 comment
Owner

Originally created by @dehidehidehi on GitHub (Nov 21, 2025).

Description

Good morning,

The documentation here states that you can set model options per agent in the opencode.json configuration file : https://opencode.ai/docs/models/#configure-models

You can also configure these options for any agents that you are using. The agent config overrides any global options here. [Learn more](https://opencode.ai/docs/agents/#additional).

But I do not see this reflected in the opencode.json schema :
https://opencode.ai/config.json

For clarity, would this structure in my config.json be valid?

{
  "$schema": "https://opencode.ai/config.json",
  "share": "disabled",
  "theme": "palenight",
  "autoupdate": true,
  "agent": {
    "example-agent": {
      "mode": "subagent",
      "model": "openai/gpt-5.1-mini",
      "options": {
        "reasoningEffort": "medium"
      }
    }
  }
}

OpenCode version

No response

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

No response

Terminal

No response

Originally created by @dehidehidehi on GitHub (Nov 21, 2025). ### Description Good morning, The documentation here states that you can set model options per agent in the opencode.json configuration file : https://opencode.ai/docs/models/#configure-models ```text You can also configure these options for any agents that you are using. The agent config overrides any global options here. [Learn more](https://opencode.ai/docs/agents/#additional). ``` But I do not see this reflected in the `opencode.json schema` : https://opencode.ai/config.json For clarity, would this structure in my config.json be valid? ```text { "$schema": "https://opencode.ai/config.json", "share": "disabled", "theme": "palenight", "autoupdate": true, "agent": { "example-agent": { "mode": "subagent", "model": "openai/gpt-5.1-mini", "options": { "reasoningEffort": "medium" } } } } ``` ### OpenCode version _No response_ ### Steps to reproduce _No response_ ### Screenshot and/or share link _No response_ ### Operating System _No response_ ### Terminal _No response_
yindo added the bug label 2026-02-16 17:38:16 -05:00
yindo closed this issue 2026-02-16 17:38:16 -05:00
Author
Owner

@rekram1-node commented on GitHub (Nov 21, 2025):

@dehidehidehi the schema does allow for it:

               "options": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },

You can pass any options so we can't set a strict schema there, it is a catch all

@rekram1-node commented on GitHub (Nov 21, 2025): @dehidehidehi the schema does allow for it: ``` "options": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, ``` You can pass any options so we can't set a strict schema there, it is a catch all
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3022