oh-my-opencode-slim/oh-my-opencode-slim.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "preset": {
      "type": "string"
    },
    "setDefaultAgent": {
      "type": "boolean"
    },
    "autoUpdate": {
      "description": "Disable automatic installation of plugin updates when false. Defaults to true.",
      "type": "boolean"
    },
    "compactSidebar": {
      "description": "Render each agent on a single line in the TUI sidebar instead of the default multi-line layout. Default false.",
      "type": "boolean"
    },
    "presets": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {
          "type": "object",
          "properties": {
            "model": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "variant": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ]
                      }
                    ]
                  }
                }
              ]
            },
            "temperature": {
              "type": "number",
              "minimum": 0,
              "maximum": 2
            },
            "variant": {
              "type": "string"
            },
            "skills": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "mcps": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "prompt": {
              "type": "string",
              "minLength": 1
            },
            "orchestratorPrompt": {
              "type": "string",
              "minLength": 1
            },
            "options": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "displayName": {
              "type": "string",
              "minLength": 1
            }
          },
          "additionalProperties": false
        }
      }
    },
    "agents": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "minItems": 1,
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "variant": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id"
                      ]
                    }
                  ]
                }
              }
            ]
          },
          "temperature": {
            "type": "number",
            "minimum": 0,
            "maximum": 2
          },
          "variant": {
            "type": "string"
          },
          "skills": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "mcps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "prompt": {
            "type": "string",
            "minLength": 1
          },
          "orchestratorPrompt": {
            "type": "string",
            "minLength": 1
          },
          "options": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "displayName": {
            "type": "string",
            "minLength": 1
          }
        },
        "additionalProperties": false
      }
    },
    "disabled_agents": {
      "description": "Agent names to disable completely. Disabled agents are not instantiated and cannot be delegated to. Orchestrator and council internal agents (councillor) cannot be disabled. By default, 'observer' is disabled. Remove it from this list and configure a vision-capable model to enable.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_mcps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_tools": {
      "description": "Tool names to disable completely. Disabled tools are not registered with OpenCode and cannot be used by agents.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_skills": {
      "description": "Skill names to disable completely. Disabled skills are not granted to agents, even when referenced by presets or agent overrides.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "multiplexer": {
      "type": "object",
      "properties": {
        "type": {
          "default": "none",
          "type": "string",
          "enum": [
            "auto",
            "tmux",
            "zellij",
            "none"
          ]
        },
        "layout": {
          "default": "main-vertical",
          "type": "string",
          "enum": [
            "main-horizontal",
            "main-vertical",
            "tiled",
            "even-horizontal",
            "even-vertical"
          ]
        },
        "main_pane_size": {
          "default": 60,
          "type": "number",
          "minimum": 20,
          "maximum": 80
        },
        "zellij_pane_mode": {
          "default": "agent-tab",
          "type": "string",
          "enum": [
            "agent-tab",
            "current-tab"
          ]
        }
      }
    },
    "tmux": {
      "type": "object",
      "properties": {
        "enabled": {
          "default": false,
          "type": "boolean"
        },
        "layout": {
          "default": "main-vertical",
          "type": "string",
          "enum": [
            "main-horizontal",
            "main-vertical",
            "tiled",
            "even-horizontal",
            "even-vertical"
          ]
        },
        "main_pane_size": {
          "default": 60,
          "type": "number",
          "minimum": 20,
          "maximum": 80
        }
      }
    },
    "websearch": {
      "type": "object",
      "properties": {
        "provider": {
          "default": "exa",
          "type": "string",
          "enum": [
            "exa",
            "tavily"
          ]
        }
      }
    },
    "interview": {
      "type": "object",
      "properties": {
        "maxQuestions": {
          "default": 2,
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "outputFolder": {
          "default": "interview",
          "type": "string",
          "minLength": 1
        },
        "autoOpenBrowser": {
          "default": true,
          "description": "Automatically open the interview UI in your default browser during interactive runs. Disabled automatically in tests and CI.",
          "type": "boolean"
        },
        "port": {
          "default": 0,
          "type": "integer",
          "minimum": 0,
          "maximum": 65535
        },
        "dashboard": {
          "default": false,
          "type": "boolean"
        }
      }
    },
    "backgroundJobs": {
      "type": "object",
      "properties": {
        "maxSessionsPerAgent": {
          "default": 2,
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "readContextMinLines": {
          "default": 10,
          "type": "integer",
          "minimum": 0,
          "maximum": 1000
        },
        "readContextMaxFiles": {
          "default": 8,
          "type": "integer",
          "minimum": 0,
          "maximum": 50
        }
      }
    },
    "fallback": {
      "type": "object",
      "properties": {
        "enabled": {
          "default": true,
          "type": "boolean"
        },
        "timeoutMs": {
          "default": 15000,
          "type": "number",
          "minimum": 0
        },
        "retryDelayMs": {
          "default": 500,
          "type": "number",
          "minimum": 0
        },
        "retry_on_empty": {
          "default": true,
          "description": "When true (default), empty provider responses are treated as failures, triggering fallback/retry. Set to false to treat them as successes.",
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "council": {
      "type": "object",
      "properties": {
        "presets": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            }
          }
        },
        "timeout": {
          "default": 180000,
          "type": "number",
          "minimum": 0
        },
        "default_preset": {
          "default": "default",
          "type": "string"
        },
        "councillor_execution_mode": {
          "default": "parallel",
          "description": "Execution mode for councillors. \"serial\" runs them one at a time (required for single-model systems). \"parallel\" runs them concurrently (default, faster for multi-model systems).",
          "type": "string",
          "enum": [
            "parallel",
            "serial"
          ]
        },
        "councillor_retries": {
          "default": 3,
          "description": "Number of retry attempts for councillors that return empty responses (e.g. due to provider rate limiting). Default: 3 retries.",
          "type": "integer",
          "minimum": 0,
          "maximum": 5
        },
        "master": {
          "description": "DEPRECATED — ignored. Council agent synthesizes directly."
        }
      },
      "required": [
        "presets"
      ]
    },
    "companion": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean"
        },
        "binaryPath": {
          "description": "Path to a custom companion binary to launch.",
          "type": "string",
          "minLength": 1
        },
        "position": {
          "type": "string",
          "enum": [
            "bottom-right",
            "bottom-left",
            "top-right",
            "top-left"
          ]
        },
        "size": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "large"
          ]
        },
        "gifPack": {
          "description": "Bundled companion animation pack to use.",
          "type": "string",
          "enum": [
            "default"
          ]
        },
        "loopStyle": {
          "description": "Companion animation playback style: classic loops or smooth ping-pong playback.",
          "type": "string",
          "enum": [
            "classic",
            "smooth"
          ]
        },
        "speed": {
          "description": "Companion animation playback speed multiplier. Defaults to 1.",
          "type": "number",
          "minimum": 0.25,
          "maximum": 4
        },
        "debug": {
          "description": "Enable verbose native companion debug logs.",
          "type": "boolean"
        }
      }
    },
    "acpAgents": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "minLength": 1
          },
          "args": {
            "default": [],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "env": {
            "default": {},
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "string"
            }
          },
          "cwd": {
            "type": "string",
            "minLength": 1
          },
          "description": {
            "type": "string",
            "minLength": 1
          },
          "prompt": {
            "type": "string",
            "minLength": 1
          },
          "orchestratorPrompt": {
            "type": "string",
            "minLength": 1
          },
          "wrapperModel": {
            "type": "string",
            "pattern": "^[^/\\s]+\\/[^\\s]+$"
          },
          "timeoutMs": {
            "default": 0,
            "description": "Timeout for a single ACP run in milliseconds. Set to 0 to disable the timeout.",
            "type": "integer",
            "minimum": 0,
            "maximum": 2147483647
          },
          "permissionMode": {
            "default": "ask",
            "type": "string",
            "enum": [
              "ask",
              "allow",
              "reject"
            ]
          }
        },
        "required": [
          "command"
        ],
        "additionalProperties": false
      }
    }
  },
  "title": "oh-my-opencode-slim",
  "description": "Configuration schema for oh-my-opencode-slim plugin for OpenCode"
}