CowboyLogic/ai-dev / skills/client-config-opencode
client-config-opencode
UnverifiedManage 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".
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 18.6 KB |
| README.md | markdown | 3.9 KB |
| SKILL.md | skill md | 8.8 KB |
| evals/evals.json | config | 6.7 KB |
| references/agents.md | markdown | 5.4 KB |
| references/config-schema.md | markdown | 14.1 KB |
| references/mcp.md | markdown | 5.1 KB |
| references/permissions.md | markdown | 5.2 KB |
| references/providers.md | markdown | 10.8 KB |
| references/tui.md | markdown | 12.7 KB |
| references/v2/agents.md | markdown | 5.1 KB |
| references/v2/cli.md | markdown | 11.1 KB |
| references/v2/config-schema.md | markdown | 31.8 KB |
| references/v2/mcp.md | markdown | 10.3 KB |
| references/v2/migration.md | markdown | 8.9 KB |
| references/v2/permissions.md | markdown | 16.1 KB |
| references/v2/plugins.md | markdown | 8.6 KB |
| references/v2/providers.md | markdown | 21.4 KB |
| scripts/show-config.py | script | 14.2 KB |
| scripts/update-references.py | script | 3.9 KB |
| sources.json | config | 7.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"
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 467k | Updated | Claude CodeCodex | Verified | Install |
| 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: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |