Skip to content

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

client-config-opencode

Unverified

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

sources.json

View on GitHub
{
  "_comment": "Source URLs for this skill's reference files. Run scripts/update-references.py to refresh. references/*.md cover V1; references/v2/*.md cover native V2.",
  "index": "https://opencode.ai/docs/config",
  "schema_urls": {
    "main": "https://opencode.ai/config.json",
    "tui": "https://opencode.ai/tui.json",
    "cli_v2": "https://opencode.ai/v2/cli.json"
  },
  "references": {
    "references/providers.md": {
      "urls": ["https://opencode.ai/docs/providers"],
      "covers": "V1: provider config, model syntax, authentication, Anthropic/OpenAI/Bedrock/Vertex/Ollama setup, apiKey format, provider options"
    },
    "references/mcp.md": {
      "urls": ["https://opencode.ai/docs/mcp-servers"],
      "covers": "V1: mcp config structure, local/remote transport types, OAuth, environment variables, CLI commands"
    },
    "references/agents.md": {
      "urls": ["https://opencode.ai/docs/agents"],
      "covers": "V1: built-in agents (build/plan/general/explore/scout), custom agent fields, markdown file format, bash glob permissions"
    },
    "references/permissions.md": {
      "urls": [
        "https://opencode.ai/docs/permissions",
        "https://opencode.ai/config.json"
      ],
      "covers": "V1: permission actions (ask/allow/deny), all tool types, bash glob patterns, defaults, global vs per-agent permissions"
    },
    "references/tui.md": {
      "urls": [
        "https://opencode.ai/docs/tui",
        "https://opencode.ai/tui.json",
        "https://opencode.ai/docs/keybinds",
        "https://opencode.ai/docs/themes"
      ],
      "covers": "V1: tui.json structure, all keybind actions, theme configuration, mouse/scroll/diff/cursor/attention settings"
    },
    "references/config-schema.md": {
      "urls": [
        "https://opencode.ai/docs/config",
        "https://opencode.ai/config.json",
        "https://opencode.ai/docs/commands",
        "https://opencode.ai/docs/formatters",
        "https://opencode.ai/docs/lsp",
        "https://opencode.ai/docs/rules",
        "https://opencode.ai/docs/skills",
        "https://opencode.ai/docs/plugins",
        "https://opencode.ai/docs/policies"
      ],
      "covers": "V1: full opencode.json schema — top-level fields, server, commands, instructions, formatters, LSP, compaction, skills, plugins, policies, watcher, managed settings"
    },
    "references/v2/config-schema.md": {
      "urls": [
        "https://opencode.ai/v2/docs/config/",
        "https://opencode.ai/v2/docs/cli/",
        "https://opencode.ai/v2/docs/cli/commands/",
        "https://opencode.ai/v2/docs/cli/web/",
        "https://opencode.ai/v2/docs/commands/",
        "https://opencode.ai/v2/docs/skills/",
        "https://opencode.ai/v2/docs/formatters/",
        "https://opencode.ai/v2/docs/compaction/",
        "https://opencode.ai/v2/docs/snapshots/",
        "https://opencode.ai/v2/docs/attachments/",
        "https://opencode.ai/v2/docs/websearch/",
        "https://opencode.ai/v2/docs/warming/",
        "https://opencode.ai/v2/docs/references/",
        "https://opencode.ai/v2/docs/instructions/",
        "https://opencode.ai/v2/docs/network/",
        "https://opencode.ai/v2/docs/troubleshooting/",
        "https://opencode.ai/v2/docs/sharing/",
        "https://raw.githubusercontent.com/anomalyco/opencode/dev/CHANGELOG.md",
        "https://raw.githubusercontent.com/anomalyco/opencode/v2.3.0/packages/schema/src/config.ts",
        "https://raw.githubusercontent.com/anomalyco/opencode/v2.3.0/packages/schema/src/config/experimental.ts",
        "https://raw.githubusercontent.com/anomalyco/opencode/v2.3.0/packages/schema/src/config/flag.ts",
        "https://raw.githubusercontent.com/anomalyco/opencode/v2.3.0/packages/core/src/flag.ts"
      ],
      "covers": "V2: config locations/precedence (system directory, macOS managed preferences), all top-level fields, ignored V1 fields, commands, skills, formatters, compaction (percentage buffer), media, websearch, warming, references, worktree, instructions (loaded), variable substitution, experimental settings, service env, background service and remote pairing, V2 release notes (CHANGELOG.md), pinned v2.3.0 config schema source (top-level `timezone`, experimental keys, feature-flag registry, flag resolver)"
    },
    "references/v2/permissions.md": {
      "urls": [
        "https://opencode.ai/v2/docs/permissions/",
        "https://opencode.ai/v2/docs/policies/",
        "https://opencode.ai/v2/docs/tools/"
      ],
      "covers": "V2: ordered permissions rules, actions/resources, defaults (external_directory allowed), approvals, policies (provider.use, tool.use, integration.connect, integration.use, mcp.use, skill.use, plugin.use, websearch.use; experimental.policies is the deprecated location), policy precedence"
    },
    "references/v2/agents.md": {
      "urls": ["https://opencode.ai/v2/docs/agents/"],
      "covers": "V2: built-in agents, agents map and markdown format, fields (system, permissions, request, disabled), default agent, subagent control"
    },
    "references/v2/mcp.md": {
      "urls": ["https://opencode.ai/v2/docs/mcp-servers/"],
      "covers": "V2: mcp.servers, local/remote fields, snake_case OAuth and client registration (pre-registered, CIMD, DCR), timeout object, protocol, Code Mode, resources, server instructions, input requests, tool naming, CLI"
    },
    "references/v2/providers.md": {
      "urls": [
        "https://opencode.ai/v2/docs/providers/",
        "https://opencode.ai/v2/docs/models/",
        "https://opencode.ai/v2/docs/cli/providers/",
        "https://opencode.ai/v2/docs/claude-agent/"
      ],
      "covers": "V2: providers map, packages, settings/headers/body, models and variants array, capabilities.reasoning, compatibility and prompt caching, request encoding, model references, ChatGPT sign-in and Claude Agent, Bedrock/Vertex/Azure/Copilot/local runtimes, credential storage"
    },
    "references/v2/cli.md": {
      "urls": [
        "https://opencode.ai/v2/docs/cli/config/",
        "https://opencode.ai/v2/docs/cli/keybinds/",
        "https://opencode.ai/v2/docs/cli/theme/",
        "https://opencode.ai/v2/docs/themes/",
        "https://opencode.ai/v2/docs/cli/plugins/",
        "https://opencode.ai/v2/cli.json"
      ],
      "covers": "V2: global cli.json settings, keybind IDs, theme selection and V2 theme format, CLI-only plugins, tui.json migration"
    },
    "references/v2/plugins.md": {
      "urls": [
        "https://opencode.ai/v2/docs/plugins/",
        "https://opencode.ai/v2/docs/build/plugins/",
        "https://opencode.ai/v2/docs/build/plugins/server/",
        "https://opencode.ai/v2/docs/build/plugins/gui/",
        "https://opencode.ai/v2/docs/build/plugins/effect/",
        "https://opencode.ai/v2/docs/build/plugins/migrate-v1/"
      ],
      "covers": "V2: plugins config and discovery (directory-only local paths), enable/disable directives, plugin CLI, desktop (GUI) plugins, Plugin.define API, V1 hook mapping"
    },
    "references/v2/migration.md": {
      "urls": ["https://opencode.ai/v2/docs/migrate-v1/"],
      "covers": "V1 to V2: breaking changes, mixing rules, field renames for permissions/agents/commands/MCP/compaction/providers/models, file locations, server authentication"
    }
  }
}
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: 467kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall