Skip to content

Config reference

FieldTypeDefaultIntroduced in
modelstring-Bring your own model
providerobject-Wire up multiple providers
permission.read"allow" | "ask" | "deny""allow"Per-tool, per-agent
permission.edit"allow" | "ask" | "deny""allow"Per-tool, per-agent
permission.bash"allow" | "ask" | "deny" or command map"allow"Per-tool, per-agent
permission.glob"allow" | "ask" | "deny""allow"Per-tool, per-agent
permission.grep"allow" | "ask" | "deny""allow"Per-tool, per-agent
permission.list"allow" | "ask" | "deny""allow"Per-tool, per-agent
permission.task"allow" | "ask" | "deny""allow"The three built-in subagents
permission.skill"allow" | "ask" | "deny" or glob map"allow"Gate which agents run it
permission.lsp"allow" | "ask" | "deny""allow"The LSP channel
compaction.autobooleantrueUndo, redo & compact
compaction.prunebooleantrueUndo, redo & compact
compaction.reservednumberprovider-dependentUndo, redo & compact
instructionsstring[][]Point at more instruction files
mcpobject{}MCP servers
agentobject{}Write a custom subagent
FieldTypeDefaultIntroduced in
themestring"opencode"Keybinds & themes
keybindsobjectsee keybinds docsLeader key & command palette
leader_timeoutnumber (ms)2000Leader key & command palette