Skip to content

CowboyLogic/ai-dev / skills/client-config-opencode

client-config-opencode

Verified

Manage OpenCode configuration files (V2 native format by default, V1 supported) including MCP servers, providers, models, agents, commands, permissions, policies, skills, plugins, CLI/TUI settings, keybinds, and themes. Use this skill whenever the user wants to view, edit, add, migrate, or understand any opencode setting in opencode.json(c), cli.json, or tui.json. Trigger on: "configure opencode", "add provider", "set model", "add MCP server", "create agent", "configure permissions", "change theme", "add keybind", "show opencode config", "add custom command", "migrate opencode config to V2", or "opencode cli.json".

FileKindSize
CHANGELOG.mdmarkdown18.6 KB
README.mdmarkdown3.9 KB
SKILL.mdskill md8.8 KB
evals/evals.jsonconfig6.7 KB
references/agents.mdmarkdown5.4 KB
references/config-schema.mdmarkdown14.1 KB
references/mcp.mdmarkdown5.1 KB
references/permissions.mdmarkdown5.2 KB
references/providers.mdmarkdown10.8 KB
references/tui.mdmarkdown12.7 KB
references/v2/agents.mdmarkdown5.1 KB
references/v2/cli.mdmarkdown11.1 KB
references/v2/config-schema.mdmarkdown31.8 KB
references/v2/mcp.mdmarkdown10.3 KB
references/v2/migration.mdmarkdown8.9 KB
references/v2/permissions.mdmarkdown16.1 KB
references/v2/plugins.mdmarkdown8.6 KB
references/v2/providers.mdmarkdown21.4 KB
scripts/show-config.pyscript14.2 KB
scripts/update-references.pyscript3.9 KB
sources.jsonconfig7.1 KB

CHANGELOG.md

View on GitHub
# Changelog

Changes to the `client-config-opencode` skill, newest first.

## 2026-11-15 — v2.6 (verified against V2 2.3.0 and V1 1.19.5)

Baselines: V2 2.2.6 → 2.3.0 (tags `v2.2.7`, 2026-11-10, and `v2.3.0`, 2026-11-13); V1 1.19.5 is the newest V1 tag and is
unchanged. Sources are the tag-to-tag diff `v2.2.6...v2.3.0` of the V2 docs source (`services/site/src/docs/content`,
16 pages changed, of which 9 bear on these skills), the V2 config schema and flag resolver source at `v2.3.0`, the V2
`CHANGELOG.md` sections for 2.2.7 and 2.3.0, and the published `cli.json` schema. The 2.3.0 binary was **not** run, so
binary-dependent claims keep their earlier basis.

- `references/v2/config-schema.md`: warming now defaults to `interval: "auto"` (it was `"4 minutes"`), with the new
  rules (explicit interval at or above `duration` is rejected, an `"auto"` one that long is skipped, subagent sessions are
  not warmed, intervals count from send time, no overlap with running requests, a cache miss stops warming) and the
  `settings.cache.warming` override now shown in the docs; the experimental flag registry grew from five to eight keys
  (`shell_timeout_background`, `console_watches`, `mcp_events`, the last two on schema descriptions and release notes
  alone), `codemode_vm` is deprecated and ignored because Code Mode always runs on the VM (which resolves the conflict
  recorded in v2.5), and the flag resolver logic is unchanged; antivirus HTTPS-scanning fix via `NODE_EXTRA_CA_CERTS`.
- `references/v2/providers.md`: new Cache lifetime (`settings.cache.ttl`) and Client certificates (`settings.tls`, mutual
  TLS) sections, and `capabilities.freeform` (`text`, `regex`, `lark`).
- `references/v2/permissions.md`, `references/v2/mcp.md`: denying `execute` now lists the tools Code Mode would reach as
  direct tools (and keeps an MCP server's instructions without the Code Mode line) instead of removing them.
- `references/v2/plugins.md`: the `-opencode.fork-notice` plugin switch for the fork notice added in 2.3.0.
- `references/v2/cli.md`: `session.verbosity` now defaults to `low` (release notes only).
- `sources.json`: schema source pins moved to `v2.3.0`, and the flag resolver source (`packages/core/src/flag.ts`) is now
  pinned so a refresh stages it.
- Not changed: subagents always running in the background is recorded in `agent-creator-opencode` (agents reference)
  because this skill has no subagent-launch coverage; Desktop, SDK, site, Console, ACP, and shell-output changes; the
  Copilot Auto model pick and other release-note-only behavior changes with no configuration surface; V1 references.

## 2026-11-08 — v2.5 (verified against V2 2.2.6 and V1 1.19.5)

Baselines: V2 2.2.5 → 2.2.6 (tag `v2.2.6`, 2026-11-06); V1 1.19.5 is the newest V1 tag and is unchanged. Sources are the
tag-to-tag diff `v2.2.5...v2.2.6` of the V2 docs source (now `services/site/src/docs/content`; it moved from
`services/www` in this release, with 14 content pages changed besides the Console, SDK, and GUI-plugin build pages), the
V2 config schema source at `v2.2.6`, and the V2 `CHANGELOG.md` entry for 2.2.6. The 2.2.6 binary was **not** run, so
binary-dependent claims keep their earlier basis.

- `references/v2/mcp.md`: new `pool` option and a Shared connections section (docs and schema); pasting the browser
  redirect URL into the sign-in prompt when OpenCode runs on another machine (docs; release notes say the same).
- `references/v2/permissions.md`: new `websearch.use` policy action with provider-ID resources (docs, schema, release
  notes). The tools page dropped its sentence that the `opencode` Code Mode namespace utilities request no built-in
  permission action, so the worktree-permission note now says it rests on the 2.2.5 page and is unverified for 2.2.6.
- `references/v2/config-schema.md`: warming `interval: "auto"` (90% of `cache.ttl`), the `interval` shorter than
  `duration` rule, and the provider and model `settings.cache.warming` override (schema and release notes only); the five registry feature flags
  now resolve through `OPENCODE_FLAGS`, `experimental.<key>`, and `all_flags` (with the new `all_flags` key), and the new
  `codemode_vm` and `part_rows` keys are separate fields;
  background compaction details (starts 60k tokens before the threshold, waits for an unfinished summary, falls back past
  about 40% of the threshold); `websearch.use` in the `policies` row.
- `references/v2/cli.md`: `session.submit_scroll` (`bottom` or `keep`, also present in the published `cli.json`) and
  the `dialog.integration.copy` keybind (docs).
- `references/v2/plugins.md`: GUI plugins can add themes, code block rendering and actions, and native settings and menu
  components (release notes and the changed GUI build page; not exercised); verification basis 2.2.6.
- `sources.json`: schema source pins moved to `v2.2.6`, `config/flag.ts` added, `covers` text updated.
- Not changed: Desktop, site, Console, and SDK changes; `opencode run --archived` and `--worktree` (CLI flags, not
  configuration surface); other `run` and ACP fixes; Azure Messages support for Foundry Claude models (release notes
  only, no configuration surface to verify); V1 references (no newer V1 tag).

## 2026-11-01 — v2.4 (verified against V2 2.2.5 and V1 1.19.5)

Baselines: V2 2.0.29 → 2.2.5 (2.0.30, 2.0.31, 2.0.32, 2.1.0 to 2.1.4, 2.2.0 to 2.2.5; tags through `v2.2.5`, 2026-10-30);
V1 1.19.0 → 1.19.5 (tag `v1.19.5`, 2026-10-28). Sources are the tag-to-tag diff `v2.0.29...v2.2.5` of the V2 docs
source (`services/www/src/docs/content`, 63 pages changed), the V2 config schema source at `v2.2.5`, the V2
`CHANGELOG.md`, and the `v1.19.0...v1.19.5` diff and commit log (the V1 GitHub release notes were not reachable from
this run, so V1 claims rest on commits). Neither binary was run, so binary-dependent claims keep their 2.0.27 basis.

- `references/v2/permissions.md`: `external_directory` is allowed by default (the `ask` rule was removed from the base
  policy; V1 asked); `explore` and `build` defaults updated; the shell scanner is always on and
  `experimental.portable_shell_scanner` is deprecated; `execute` deny semantics; new actions
  `opencode_list_mcp_resources`, `opencode_read_mcp_resource`, `experimental_image_generate`. Policies: new
  `integration.connect`, `mcp.use`, `skill.use`, `plugin.use`; `integration.use` now covers integrations only (breaking
  change in 2.2.3, with the migration warning); policy precedence puts managed preferences and the system file above the
  Console workspace.
- `references/v2/config-schema.md`: `compaction.buffer` percentages and the new `"15%"` default; summaries cover the
  whole conversation; `agents.compaction.model`; `instructions` now loads (2.0.30); documented `{env:}`/`{file:}`
  substitution; new Experimental section (`todo`, `subagent_depth`, `background_compaction`, `image_generate`,
  `location_idle_timeout`, `schedules`, `artifacts`, `media_blob`); top-level `timezone`; skill discovery rules;
  `share` no longer functional; `OPENCODE_PASSWORD`, `OPENCODE_CLAUDE_PATH`, `OPENCODE_DISABLE_FREE_MODELS`; default
  server ports.
- `references/v2/mcp.md`: client registration order (pre-registered, CIMD, DCR), updated OAuth field semantics,
  resources and their permission actions, server instructions, input requests (elicitation), `mcp auth` without a name,
  `--env` and `--header` flags, global timeouts apply to config-file servers.
- `references/v2/providers.md`: ChatGPT sign-in context caps and the `openai-context-caps` plugin, the Claude Agent
  provider, model `type`, `releaseDate`, and `capabilities.reasoning`, compatibility `streamUsage` and `mediaInput`; the
  streamed-chunk timeout conflict between the 2.0.29 docs (five minutes) and the 2.2.5 docs (fifteen) is recorded.
- `references/v2/plugins.md`: configured local paths must be directories; desktop (GUI) plugins; OpenTUI 0.8; new
  session, instruction-entry, idle, and artifact plugin APIs (release notes only); 2.1.0 provider replay data renamed to
  `native`.
- `references/v2/agents.md`, `references/v2/migration.md`: agent files are read as one format; agent `request.body` is
  not sent so V1 `temperature`/`top_p`/`options` need a model variant; server authentication variables; `external_directory`
  and todo defaults.
- `references/v2/cli.md`: unknown `cli.json` settings and keybind IDs are now ignored (not rejected); `diff.toggle_fullscreen`
  and `location.reload` keybinds.
- V1 references (source and commits only): session sharing was discontinued in 1.19.1; `reasoning_options` on provider
  models in 1.19.3.
- `SKILL.md`, `sources.json`: instructions row, policy example, `{file:}` note, new source pages (Claude Agent, plugin
  server and GUI pages), `covers` text.
- Not changed: Desktop, GUI-plugin build details, SDK package, and TUI behavior; CLI command flags that are not config
  surface (`opencode run --session`, `stats --project`, `uninstall`); and V1 changes with no config surface (1.19.2
  keeps updates on 1.x; CI and Bun 1.4.4 changes).

## 2026-10-14 — v2.3 (verified against V2 2.0.29 and V1 1.19.0)

Baselines: V2 2.0.27 → 2.0.29 (108 commits; 11 docs pages changed); V1 1.19.0 is unchanged. Sources are
the tag-to-tag diff `v2.0.27...v2.0.29` of the V2 docs source and the config schema/core source, the V2
`CHANGELOG.md` (2.0.28 at the 2.0.29 tag, 2.0.29 on `dev`), and the published `cli.json` schema. The
2.0.29 binary was **not** run, so binary-dependent claims keep their 2.0.27 basis.

- `references/v2/permissions.md`: policies live under top-level `policies` (2.0.29); `experimental.policies`
  still works and merges in. The `permission` policy action in earlier versions of this skill is not a valid
  value in the 2.0.27 or 2.0.29 schema; the actions are `provider.use`, `tool.use`, and `integration.use`.
  Documented `integration.use` (`mcp:`, `skill:`, `plugin:` resources) and the full policy precedence
  table (Console, macOS managed preferences, system directory, global, project).
- `references/v2/config-schema.md`: system configuration directory (macOS, Linux, Windows) and macOS managed
  preferences with highest precedence; the "MDM managed settings are V1-only" note no longer applies to those
  two. Added the top-level `policies` row. Re-baselined unchanged docs claims to 2.0.29.
- `references/v2/providers.md`: new Compatibility section (provider-level `compatibility`, the full field list
  from the schema, `cacheFormat` for Claude models behind OpenAI-compatible proxies); new Request encoding
  section (`settings.encoding`); streamed-chunk timeout default is 15 minutes since 2.0.28 (the docs page still
  says five).
- `references/v2/cli.md`: top-level `highlights` boolean in `cli.json` (release highlights dialog, `/highlights`).
- `references/v2/plugins.md`: `ctx.credential.activate` and `ctx.permission.assert`.
- `references/v2/migration.md`: `enabled_providers` / `disabled_providers` map to `policies`; V1
  `options.setCacheKey` maps to `compatibility.supportsPromptCacheKey`; the V2 CLI source defines no
  `upgrade --major` option.
- `SKILL.md`: system/managed row in the file map and the `policies` quick edit.
- `sources.json`: `covers` text for the permissions, config, and providers references.
- Not changed: V1 references (no V1 release since 1.19.0), `references/v2/agents.md`, and `references/v2/mcp.md`
  (their docs pages are identical between 2.0.27 and 2.0.29).

## 2026-10-12 — v2.2 (verified against V2 2.0.27 and V1 1.19.0)

Baselines: V2 2.0.26 → 2.0.27; V1 1.19.0 is unchanged (no V1 release since 2026-10-11). V2 now
publishes release notes in the repository's `CHANGELOG.md`, so this update uses them together with a
tag-to-tag diff of the V2 docs source, the published `cli.json` schema, and the 2.0.27 binary. The
notes for 2.0.26 first appeared in that file after the 2.0.26 tag.

- `references/v2/permissions.md`: the tools page lists Code Mode worktree utilities
  (`worktree_create`, `worktree_list`, `worktree_remove`); `worktree_remove` requests `edit` with the
  worktree directory as its resource, and the other two request no built-in permission action.
- `references/v2/cli.md`: `session.verbosity` (`low` | `medium` | `high`) is in the published
  `cli.json` schema but not on the V2 settings page; `FORCE_HYPERLINK=1` forces OSC 8 hyperlinks when
  terminal detection does not enable them (2.0.26 release notes).
- `references/v2/providers.md`: `/connect` → Vertex offers Google Cloud credentials (gcloud auth or
  environment) since 2.0.26; ADC honors `CLOUDSDK_CONFIG` since 2.0.27.
- `references/v2/config-schema.md`: `opencode pair --remote` asks for confirmation the first time it
  enables remote access, and `--yes` accepts for non-interactive use; the remote URL is a persistent
  random subdomain and a new one is issued when remote access is turned off and on again.
- `references/v2/plugins.md`: Effect plugins declare `effect` as a `peerDependency`, now
  `^4.0.0` in the docs (was `>=4.0.0-rc.112`).
- Re-verified on 2.0.27: `{file:...}` substitution in agent `system` (`opencode debug config`),
  `opencode auth export` and `auth import` appear in `auth --help` but not in the V2 docs, `opencode
  upgrade --help` has no `--major`, and `permission.mode`, `plugins.install`, and
  `dialog.plugins.install` are still absent from the published `cli.json` schema.
- `sources.json`: added the V2 CLI `commands` and `web` pages, the Effect plugin page, and the V2
  `CHANGELOG.md`.
- Not changed: the V1 references, and the V2 agents and MCP references (their docs pages are identical
  between 2.0.26 and 2.0.27).

## 2026-10-11 — v2.1 (verified against V2 2.0.26 and V1 1.19.0)

Baselines: V2 2.0.16 → 2.0.26 and V1 1.18.29 → 1.19.0. V2 publishes no release notes, so V2
changes come from a tag-to-tag diff of the V2 docs source, the published `cli.json` schema, and the
2.0.26 binary. V1 changes come from the 1.19.0 release notes and a tag-to-tag diff of the V1 docs.

- V1 `references/config-schema.md`: `autoupdate` now only checks and notifies; updates are never
  installed automatically (`/update` or `opencode upgrade` installs). The published JSON schema
  description still says `true` auto-updates, and the note says so.
- `references/v2/cli.md`: `diffs.source` accepts `turn`; `prompt.queue` is `<leader>return` and
  `input.newline` also accepts `alt+return`; added `queued_prompt.undo`, `theme.switch`, and
  `terminal.toggle`; the `permission.mode`, `plugins.install`, and `dialog.plugins.install` keybind IDs
  are no longer in the docs or schema.
- `references/v2/config-schema.md`: compaction `buffer` defaults to 10% of the limit (the 2.0.16
  docs said `20000`); skill frontmatter gains `disable-model-invocation` and drops `slash` and
  `metadata.opencode/slash` from the docs; formatter `{}` preserves inherited settings while `true`
  resets them; `tinyfish` web search provider; `opencode service set disabled true`.
- `references/v2/providers.md`: provider-wide `headerTimeout`, `chunkTimeout`, and `timeout`
  (defaults and retry behavior); Azure deployment discovery and `resourceName` precedence;
  `opencode auth export` and `auth import` (in `--help`, not in the docs).
- `references/v2/migration.md`: V1 `autoupdate: true` maps to `update: "auto"`, which is more
  aggressive than V1 1.19.0; compaction `reserved` carries over only when set explicitly.
- `references/v2/plugins.md`: the V1 object entrypoint is supported in `1.18.29` and newer.
- `references/v2/migration.md`: noted that the V1 1.19.0 docs list `opencode upgrade --major`, which
  upgrades to OpenCode 2 and removes OpenCode 1.
- `{file:...}` substitution in agent `system` re-verified on 2.0.26 with `opencode debug config`.
- `sources.json`: added the V2 CLI index page, which documents the background service.

## 2026-09-24 — v2.0 (OpenCode V2 support)

- `SKILL.md`: rewritten with a format-selection step (read first; no file → V2; V1-shaped
  file stays V1), a V1/V2 detection signals table, and side-by-side file and task maps.
- New `references/v2/`: `config-schema.md`, `permissions.md` (ordered `permissions` rules),
  `agents.md`, `mcp.md` (`mcp.servers`, snake_case OAuth, split timeouts), `providers.md`,
  `cli.md` (`cli.json` and a `tui.json` → `cli.json` key map), `plugins.md` (new
  `Plugin.define` API), and `migration.md`.
- V1 references refreshed and labelled V1. Corrections: `server` settings nest under a
  `server` object; Anthropic Pro/Max login is no longer supported; formatters and LSP are
  off unless configured and use a `$FILE` placeholder; the `task` permission governs
  subagent launches; keybinds are disabled with `"none"` or `false`.
- `sources.json`: V2 doc URLs, the `v2/cli.json` schema, and additional V1 pages.
- `scripts/show-config.py`: JSONC parsing, `.opencode/opencode.json(c)` and `cli.json`
  support, and V1/V2/mixed format detection.
- `evals/evals.json`: existing cases pinned to V1; three V2 cases added (MCP OAuth,
  reviewer agent permissions, `cli.json` keybinds).

## 2026-04-26 — v1.0 (initial release)

- `SKILL.md`: Full task-to-reference map; common quick-edit snippets; `tool_output` quick
  edit added; deprecation callout for `autoshare` → `share`, `maxSteps` → `steps`,
  `tools` → `permission`.
- `references/providers.md`: Added GitLab Duo, Helicone, llama.cpp (distinct from LM Studio),
  and OpenRouter sections. Added comprehensive model fields reference table (family, status,
  modalities, reasoning, variants, timeout, interleaved). Added `whitelist`/`blacklist` model
  filtering section. Added `enterpriseUrl` provider option.
- `references/tui.md`: Added `leader` key documentation. Added `app_exit` action. Expanded
  keybind tables to cover all actions: input editing (`input_*`), terminal controls
  (`terminal_suspend`, `title_toggle`, `tips_toggle`), model/agent (`model_provider_list`,
  `variant_cycle`, `model_reverse`, `agent_reverse`), and UI (`plugin_manager`,
  `display_thinking`, `tool_details`). Added `plugin` and `plugin_enabled` fields to TUI
  options table. Added `[!TIP]` callout for Shift+Enter terminal configuration.
- `references/config-schema.md`: Added `enterprise` field to core fields table. Noted
  `autoshare` and `layout` as deprecated. Added `lsp` section with full field reference.
  Added `tool_output` section (max_lines, max_bytes). Updated `compaction` with `tail_turns`
  and `preserve_recent_tokens` fields. Expanded commands section with full template syntax
  table (`$ARGUMENTS`, `$1`/`$2`, shell injection with `` !`cmd` ``, `@file` includes).
  Expanded built-in formatters list (25 formatters including `oxfmt`, `uv`, `zig`, `gleam`,
  `ktlint`, `nixfmt`, and others).
- `references/agents.md`: Added `compaction`, `title`, and `summary` system agents to
  built-in agents table. Added `task` permission example with glob patterns and explanation.
- `evals/evals.json`: Created 4 eval cases covering MCP remote OAuth, GitLab Duo provider,
  custom read-only agent, and keybind configuration.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall