CowboyLogic/ai-dev / skills/client-config-opencode
client-config-opencode
VerifiedManage 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 |
evals/evals.json
View on GitHub[
{
"id": "add-mcp-remote-oauth",
"prompt": "I'm still on OpenCode V1. Add a remote MCP server named 'sentry' to my opencode.json. It should connect to https://mcp.sentry.io/mcp, use OAuth authentication, and have a 10-second timeout. Show me the exact JSON to add.",
"assertions": [
{ "id": "correct-type-remote", "description": "Sets type to 'remote'" },
{ "id": "correct-url", "description": "Uses url field with https://mcp.sentry.io/mcp" },
{ "id": "oauth-not-false", "description": "Does not set oauth: false (leaves it for auto or provides OAuth config)" },
{ "id": "correct-timeout", "description": "Sets timeout to 10000 (milliseconds)" },
{ "id": "correct-nesting", "description": "Entry is nested under top-level 'mcp' object with key 'sentry'" },
{ "id": "enabled-field", "description": "Includes enabled: true or omits it (not sets to false)" }
]
},
{
"id": "configure-gitlab-duo-provider",
"prompt": "I'm on OpenCode V1. I want to use GitLab Duo as an AI provider in opencode. How do I configure it? I'm using a self-hosted GitLab instance at https://gitlab.mycompany.com. Include the environment variable setup.",
"assertions": [
{ "id": "identifies-gitlab-provider", "description": "Names the provider as 'gitlab' or equivalent" },
{ "id": "mentions-gitlab-token", "description": "References GITLAB_TOKEN environment variable" },
{ "id": "mentions-instance-url", "description": "References GITLAB_INSTANCE_URL or equivalent for self-hosted" },
{ "id": "env-var-syntax", "description": "Uses {env:VARIABLE_NAME} syntax for secrets in config" },
{ "id": "correct-provider-structure", "description": "Shows the provider block inside the 'provider' object in opencode.json" }
]
},
{
"id": "custom-agent-read-only",
"prompt": "My opencode.json uses the V1 format. Create a custom opencode agent called 'auditor' that: is a subagent, uses claude-sonnet-4-5, has read-only permissions (can read files but cannot edit or run bash), and has a temperature of 0.1. Show me both the JSON config and the equivalent markdown agent file.",
"assertions": [
{ "id": "correct-mode-subagent", "description": "Sets mode to 'subagent'" },
{ "id": "correct-model", "description": "Sets model to anthropic/claude-sonnet-4-5 or similar" },
{ "id": "edit-deny", "description": "Sets permission.edit to 'deny'" },
{ "id": "bash-deny", "description": "Sets permission.bash to 'deny'" },
{ "id": "read-allow", "description": "Sets permission.read to 'allow'" },
{ "id": "correct-temperature", "description": "Sets temperature to 0.1" },
{ "id": "shows-markdown-format", "description": "Shows YAML frontmatter format for the .md agent file" },
{ "id": "correct-file-location", "description": "Mentions ~/.config/opencode/agents/ or .opencode/agents/ as the file location" }
]
},
{
"id": "keybind-leader-and-disable",
"prompt": "I'm running OpenCode V1. How do I change the leader key in opencode from the default to ctrl+space? Also, how do I disable the session_fork keybind entirely? Which config file do these go in?",
"assertions": [
{ "id": "correct-file-tui-json", "description": "Identifies tui.json (not opencode.json) as the target file" },
{ "id": "correct-file-path", "description": "Gives correct path ~/.config/opencode/tui.json" },
{ "id": "leader-key-syntax", "description": "Shows keybinds.leader: 'ctrl+space' or equivalent" },
{ "id": "disable-empty-string", "description": "Shows setting session_fork to 'none' or false to disable" },
{ "id": "keybinds-object", "description": "Shows both changes nested inside a 'keybinds' object" }
]
},
{
"id": "v2-mcp-remote-oauth",
"prompt": "Add a remote MCP server named 'sentry' to my project's opencode.jsonc (new config, nothing there yet). It should connect to https://mcp.sentry.dev/mcp, use OAuth with a pre-registered client ID from the SENTRY_CLIENT_ID environment variable, and allow tool calls up to 2 minutes. Show the exact JSONC.",
"assertions": [
{ "id": "v2-servers-nesting", "description": "Nests the entry under mcp.servers.sentry (not directly under mcp)" },
{ "id": "v2-type-remote", "description": "Sets type to 'remote' and url to https://mcp.sentry.dev/mcp" },
{ "id": "v2-snake-case-oauth", "description": "Uses oauth.client_id (snake_case), not clientId" },
{ "id": "v2-env-substitution", "description": "Uses {env:SENTRY_CLIENT_ID} for the client ID" },
{ "id": "v2-timeout-object", "description": "Sets timeout as an object with execution: 120000 (not a bare number)" },
{ "id": "v2-no-enabled", "description": "Does not use an 'enabled' field (V2 uses 'disabled' if anything)" }
]
},
{
"id": "v2-reviewer-agent-permissions",
"prompt": "Using the native OpenCode V2 config format, create a 'reviewer' subagent in opencode.jsonc that uses anthropic/claude-sonnet-4-5 with the 'high' variant, cannot edit files or run shell commands, and uses temperature 0.1. Also make the build agent ask before any 'git push'. Show the JSONC.",
"assertions": [
{ "id": "v2-agents-key", "description": "Uses the plural 'agents' map, not 'agent'" },
{ "id": "v2-mode-subagent", "description": "Sets mode: 'subagent' on reviewer" },
{ "id": "v2-model-variant", "description": "Sets model to 'anthropic/claude-sonnet-4-5#high' (variant joined with #), not a separate variant field" },
{ "id": "v2-permissions-array", "description": "Uses a 'permissions' array of {action, resource, effect} rules" },
{ "id": "v2-edit-shell-deny", "description": "Denies action 'edit' and action 'shell' (not 'bash') for reviewer" },
{ "id": "v2-temperature-request-body", "description": "Puts temperature under request.body, not as a top-level agent field" },
{ "id": "v2-git-push-ask", "description": "Adds { action: 'shell', resource: 'git push *', effect: 'ask' } under agents.build.permissions" }
]
},
{
"id": "v2-cli-json-keybind-theme",
"prompt": "I'm on OpenCode V2. Change my leader key to ctrl+space, disable the session fork keybind, and switch to the catppuccin theme locked to dark mode. Which file, and what JSON?",
"assertions": [
{ "id": "v2-cli-json-file", "description": "Targets ~/.config/opencode/cli.json (not tui.json or opencode.json)" },
{ "id": "v2-no-project-file", "description": "Does not suggest a project-local cli.json" },
{ "id": "v2-leader", "description": "Sets keybinds.leader to 'ctrl+space'" },
{ "id": "v2-dotted-id", "description": "Disables 'session.fork' (dotted ID) with 'none' or false" },
{ "id": "v2-theme-object", "description": "Sets theme as an object: { name: 'catppuccin', mode: 'dark' }" }
]
}
]
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 |