opencode.example.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": [
    // Standard install (the entry the `opencode plugin add` flow writes; the
    // installer merges the classifier options into it). Every entry below can
    // also carry these options when the plugin was registered manually.
    // Options:
    //   provider       llamacpp | ollama | lmstudio | typesafe | openrouter | vercel |
    //                  opencode | custom. Sets the default baseURL. Every preset
    //                  serves the classifier at <baseURL>/systemone:
    //                    llamacpp   http://127.0.0.1:8080/v1 (llama.cpp server with
    //                               decision-model support, model like "kev" or
    //                               any decision GGUF served)
    //                    ollama    http://127.0.0.1:11434/v1 (Ollama 0.35 onwards,
    //                               decision model like "nimble" or "d1")
    //                    lmstudio  http://127.0.0.1:1234/v1 (LM Studio 0.4.26
    //                               onwards, decision model from the catalog)
    //                    typesafe   https://api.typesafe.ai/v1 (TypeSafe API, Jev,
    //                               model like "jev-latest")
    //                    openrouter https://openrouter.ai/api/v1 (model like
    //                               "typesafe/jev-1.14" or "~typesafe/jev-latest")
    //                    vercel    https://ai-gateway.vercel.sh/typesafe/v1
    //                               (Vercel AI Gateway, model like "typesafe-ai/jev")
    //                    opencode  https://opencode.ai/zen/v1 (OpenCode Zen, model
    //                               like "jev-1.13" or "jev-1.13-free")
    //   baseURL        Base URL of a System One endpoint. Overrides the provider
    //                  default. The classifier is always asked through the System
    //                  One shape (model, state, questions) at <baseURL>/systemone:
    //                  System One models return typed decisions, never text.
    //   model          Classifier model ID. Required.
    //   fallbackModel  Optional second classifier model on the same endpoint and
    //                  key, retried once when the primary model rejects the
    //                  request — e.g. when a limited-time free model window
    //                  closes ("jev-1.13-free" falling back to "jev-1.13").
    //   apiKey         Optional Bearer token. Use "{env:NAME}" instead of a literal key.
    //   debugLog       Optional file path. Appends each primary request body after rewrites.
    //   tools          Tool exposure: "auto" (default) narrows the tool set to what
    //                  each prompt needs (saving input tokens). Tools are judged
    //                  by purpose group (web, shell, edit, read, agents, other) —
    //                  one question per group — and a kept group keeps its whole
    //                  family. The common core (read/search/edit/shell/task) plus
    //                  reflex_run is always kept, so the model keeps its direct
    //                  tools and only the long tail (web, exec, subagents…) is
    //                  trimmed to what the task needs or the model already used.
    //                  "all" keeps every tool exposed.
    //                  Everything is kept if the classifier is unavailable.
    //   loopDetection  Stuck-loop guard: "auto" (default) watches completed tool
    //                  calls and nudges the model when it repeats the same call.
    //                  Identical arguments with identical output are flagged
    //                  deterministically; repeats whose output varies are judged
    //                  by the classifier. "off" disables the guard.
    //   skillSuggestions  Skill suggestions: "auto" (default) asks the classifier
    //                  once per conversation, on its initial prompt, which skills
    //                  available to the agent fit the task — one batched question
    //                  per skill, riding the same System One request as the other
    //                  decisions — and nudges the model toward the top matches.
    //                  Follow-up prompts are not re-checked; the nudge drops a
    //                  skill once the model loads it. "off" disables it.
    //   agentDocs      Project guidance nudge: "auto" (default) checks the
    //                  repository root once per conversation, on its initial
    //                  prompt, and when the project carries agent guidance
    //                  (an AGENTS.md file or a .ai/ directory) injects a
    //                  one-line note asking the model to read it before
    //                  starting the task. The note is not repeated on later
    //                  prompts. "off" disables it.

    // Standard install (register once through `opencode plugin add
    // github:psygreg/agent-reflex`; the installer merges these options into
    // that entry). Classifier on a local llama.cpp server with the System One
    // API (/systemone), custom port. Effort control is automatic: every model
    // that supports it gets effort written in its own dialect (see the
    // "primaryBackend" note above), so no backend option is needed for the
    // examples below.
    {
      "package": "github:psygreg/agent-reflex",
      "options": {
        "provider": "llamacpp",
        "baseURL": "http://127.0.0.1:1123/v1",
        "model": "liquid-d1"
      }
    },

    // Legacy local-copy layout (plugins/reflex next to this config), same
    // options. The installer migrates this form to the standard package on
    // the next update run. Never register BOTH entries: the plugin would
    // load twice.
    {
      "package": "./plugins/reflex",
      "options": {
        "provider": "llamacpp",
        "baseURL": "http://127.0.0.1:1123/v1",
        "model": "liquid-d1"
      }
    },

    // Main agent on a local llama.cpp or Ollama server (identified once per
    // origin via /v1/models): top-level reasoning_effort, "low" keeping
    // thinking at its lowest level and "medium"/"high" scaling it
    // (model-defined names and compatibility aliases on Ollama); llama.cpp
    // additionally gets chat_template_kwargs.enable_thinking for Qwen-style
    // on/off templates.
    // Main agent on LM Studio: no reasoning field is documented on its
    // OpenAI-compatible endpoint yet, so those requests stay untouched.
    // Main agent on a Z.ai GLM model (GLM-5.2 onwards): thinking.type +
    // reasoning_effort on the Z.ai API, reasoning_effort alone through the
    // OpenCode Go gateway, detected per request.
    // Main agent on an OpenAI GPT reasoning model: reasoning.effort on the
    // Responses API or reasoning_effort on Chat Completions.
    // Multimodel setups work without extra options: each model gets its own
    // fields, so switching models mid-session never sends a foreign field.
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "llamacpp",
    //     "model": "liquid-d1",
    //   }
    // },

    // Classifier on Jev, TypeSafe AI's System One decision model, through the
    // TypeSafe API directly. Model IDs like "jev-latest" or a pinned release.
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "typesafe",
    //     "model": "jev-latest",
    //     "apiKey": "{env:TYPESAFE_API_KEY}"
    //   }
    // },

    // Classifier on Jev through OpenRouter (same OpenRouter API key as the
    // Decisions API). Model IDs like "typesafe/jev-1.14" or "~typesafe/jev-latest".
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "openrouter",
    //     "model": "~typesafe/jev-latest",
    //     "apiKey": "{env:OPENROUTER_API_KEY}"
    //   }
    // },

    // Classifier on Jev through the Vercel AI Gateway (TypeSafe-compatible
    // surface). Model IDs like "typesafe-ai/jev".
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "vercel",
    //     "model": "typesafe-ai/jev",
    //     "apiKey": "{env:AI_GATEWAY_API_KEY}"
    //   }
    // },

    // Classifier on the limited-time free Jev on OpenCode Zen, falling back to
    // the paid twin automatically when the free window closes. Model IDs like
    // "jev-1.13" (paid), "jev-1.13-free" (limited-time free).
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "opencode",
    //     "model": "jev-1.13-free",
    //     "fallbackModel": "jev-1.13",
    //     "apiKey": "{env:OPENCODE_ZEN_API_KEY}"
    //   }
    // },

    // Classifier on Ollama (0.35 onwards) with a decision model like "nimble"
    // (bundled with 0.35) or "d1" (Liquid AI), asked through Ollama's
    // /v1/systemone endpoint. Older Ollama versions don't serve the endpoint
    // and every classifier question fails soft (the plugin keeps working
    // without classification).
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "ollama",
    //     "model": "nimble"
    //   }
    // },

    // Classifier on LM Studio (0.4.26 onwards) with a decision model from the
    // catalog, asked through LM Studio's /v1/systemone endpoint. Older LM
    // Studio versions don't serve the endpoint and every classifier question
    // fails soft (the plugin keeps working without classification).
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "lmstudio",
    //     "model": "YOUR-DECISION-MODEL-ID"
    //   }
    // },

    // Custom remote System One endpoint (any server serving the System One shape
    // at <baseURL>/systemone, e.g. a TypeSafe-compatible re-host) with an API
    // key from the environment.
    // {
    //   "package": "./plugins/reflex",
    //   "options": {
    //     "provider": "custom",
    //     "baseURL": "https://YOUR-PROVIDER-HOST/v1",
    //     "model": "YOUR-MODEL-ID",
    //     "apiKey": "{env:SYSTEMONE_API_KEY}"
    //   }
    // }
  ]
}