feat: jsonc configuration file support (#1434)

1 files changed, 8 insertions, 2 deletions

diff --git a/packages/web/src/content/docs/docs/config.mdx b/packages/web/src/content/docs/docs/config.mdx
index abd05c335..01a165373 100644
--- a/packages/web/src/content/docs/docs/config.mdx
+++ b/packages/web/src/content/docs/docs/config.mdx
@@ -5,9 +5,14 @@ description: Using the opencode JSON config.
 
 You can configure opencode using a JSON config file.
 
-```json title="opencode.json"
+## Format
+
+opencode supports both JSON and JSONC (JSON with Comments) formats. You can use comments in your configuration files:
+
+```jsonc title="opencode.jsonc"
 {
   "$schema": "https://opencode.ai/config.json",
+  // Theme configuration
   "theme": "opencode",
   "model": "anthropic/claude-sonnet-4-20250514",
   "autoupdate": true
@@ -199,7 +204,7 @@ about rules here](/docs/rules).
 
 You can configure specialized agents for specific tasks through the `agent` option.
 
-```json title="opencode.json"
+```jsonc title="opencode.jsonc"
 {
   "$schema": "https://opencode.ai/config.json",
   "agent": {
@@ -208,6 +213,7 @@ You can configure specialized agents for specific tasks through the `agent` opti
       "model": "anthropic/claude-sonnet-4-20250514",
       "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
       "tools": {
+        // Disable file modification tools for review-only agent
         "write": false,
         "edit": false
       }