opencode-configlisted

# OpenCode Configuration > **📚 Official Docs:** For the latest information, always refer to the official documentation: > [https://opencode.ai/docs/config/](https://opencode.ai/docs/config/) OpenCode uses JSON-based configuration files to control runtime behavior, TUI appearance, server settings, tool permissions, agent definitions, and provider connections. This skill covers every aspect of configuration: file format, locations, precedence, merging, all available fields, TUI config, variable substitution, enterprise managed settings, environment variables, and troubleshooting. --- ## Table of Contents - [Format](#format) - [Config Locations & Precedence](#config-locations--precedence) - [Config Merging Behavior](#config-merging-behavior) - [All Config Fields](#all-config-fields) - [TUI Config (tui.json)](#tui-config-tuijson) - [Variable Substitution](#variable-substitution) - [Managed Settings (Enterprise)](#managed-settings-enterprise) - [Provider-Specific Options](#provider-specific-options) - [Environment Variables](#environment-variables) - [Debugging & Verification](#debugging--verification) - [Troubleshooting](#troubleshooting) --- ## Format OpenCode supports both **JSON** and **JSONC** (JSON with Comments) formats for all configuration files. ### Schema Every config file should include a `$schema` field for editor validation and autocomplete: - **Server/runtime config**: `"$schema": "https://opencode.ai/config.json"` - **TUI config**: `"$schema": "https://