canxin का ब्लॉग - ai-coding
canxin का ब्लॉग।
Zola
2026-03-18T00:00:00+00:00
https://blog.cxits.cn/hi/tags/ai-coding/atom.xml
OpenCode Config शेयर: Default Agent, Plugins और Provider
2026-03-18T00:00:00+00:00
2026-03-18T00:00:00+00:00
canxin
https://blog.cxits.cn/hi/blog/my-opencode-setup/
<h2 id="1-vrtmaan-konnph-igreshn"><a class="zola-anchor" href="#1-vrtmaan-konnph-igreshn" aria-label="Anchor link for: 1-vrtmaan-konnph-igreshn"><i class="icon"></i></a>
1. वर्तमान कॉन्फ़िगरेशन</h2>
<pre class="giallo" style="color: #839496; background-color: #002B36;"><code data-lang="jsonc"><span class="giallo-l"><span>{</span></span>
<span class="giallo-l"><span style="color: #859900;"> "$schema"</span><span>:</span><span style="color: #2AA198;"> "https://opencode.ai/config.json"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "autoupdate"</span><span>:</span><span style="color: #B58900;"> false</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "compaction"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "auto"</span><span>:</span><span style="color: #B58900;"> true</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "prune"</span><span>:</span><span style="color: #B58900;"> true</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "default_agent"</span><span>:</span><span style="color: #2AA198;"> "cx-local"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "model"</span><span>:</span><span style="color: #2AA198;"> "openai/gpt-5.3-codex"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "small_model"</span><span>:</span><span style="color: #2AA198;"> "openai/gpt-5.1-codex-mini"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "plugin"</span><span>: [</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-planpilot"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-workbench"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-web-preview"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-cx-agents"</span></span>
<span class="giallo-l"><span> ],</span></span>
<span class="giallo-l"><span style="color: #859900;"> "provider"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "anthropic"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:CLAUDE_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1"</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "google"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:GEMINI_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1beta"</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> },</span></span>
<span class="giallo-l"><span style="color: #859900;"> "openai"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "options"</span><span>: {</span></span>
<span class="giallo-l"><span style="color: #859900;"> "apiKey"</span><span>:</span><span style="color: #2AA198;"> "{env:OPENAI_API_KEY}"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "baseURL"</span><span>:</span><span style="color: #2AA198;"> "https://gateway.example.com/v1"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #859900;"> "setCacheKey"</span><span>:</span><span style="color: #B58900;"> true</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span> }</span></span>
<span class="giallo-l"><span>}</span></span></code></pre><h2 id="2-merge-precedence"><a class="zola-anchor" href="#2-merge-precedence" aria-label="Anchor link for: 2-merge-precedence"><i class="icon"></i></a>
2. Merge precedence</h2>
<p>OpenCode precedence (low -> high):</p>
<ol>
<li>Remote <code>.well-known/opencode</code></li>
<li>Global <code>~/.config/opencode/opencode.json</code></li>
<li><code>OPENCODE_CONFIG</code></li>
<li>Project <code>opencode.json</code></li>
<li><code>.opencode</code> directories (agents/commands/plugins)</li>
<li><code>OPENCODE_CONFIG_CONTENT</code></li>
</ol>
<p>Global layer long-term defaults के लिए उपयुक्त है: <code>default_agent</code>, <code>model</code>, <code>small_model</code>, shared providers और shared plugins.</p>
<h2 id="3-top-level-fields"><a class="zola-anchor" href="#3-top-level-fields" aria-label="Anchor link for: 3-top-level-fields"><i class="icon"></i></a>
3. Top-level fields</h2>
<table><thead><tr><th style="text-align: left">Field</th><th style="text-align: left">Current value</th><th style="text-align: left">भूमिका</th><th style="text-align: left">नोट</th></tr></thead><tbody>
<tr><td style="text-align: left"><code>$schema</code></td><td style="text-align: left"><code>https://opencode.ai/config.json</code></td><td style="text-align: left">JSON validation + autocomplete</td><td style="text-align: left">रखना चाहिए</td></tr>
<tr><td style="text-align: left"><code>autoupdate</code></td><td style="text-align: left"><code>false</code></td><td style="text-align: left">Auto update बंद</td><td style="text-align: left">Stability-first workflow</td></tr>
<tr><td style="text-align: left"><code>compaction.auto</code></td><td style="text-align: left"><code>true</code></td><td style="text-align: left">लंबे sessions auto compact</td><td style="text-align: left">Recommended</td></tr>
<tr><td style="text-align: left"><code>compaction.prune</code></td><td style="text-align: left"><code>true</code></td><td style="text-align: left">पुराने tool output prune</td><td style="text-align: left">Context bloat कम करता है</td></tr>
<tr><td style="text-align: left"><code>default_agent</code></td><td style="text-align: left"><code>cx-local</code></td><td style="text-align: left">Default agent</td><td style="text-align: left">Plugin द्वारा उपलब्ध (0.2.0 से recommended)</td></tr>
<tr><td style="text-align: left"><code>model</code></td><td style="text-align: left"><code>openai/gpt-5.3-codex</code></td><td style="text-align: left">Main model</td><td style="text-align: left">Primary path</td></tr>
<tr><td style="text-align: left"><code>small_model</code></td><td style="text-align: left"><code>openai/gpt-5.1-codex-mini</code></td><td style="text-align: left">Lightweight model</td><td style="text-align: left">Helper path / cost</td></tr>
<tr><td style="text-align: left"><code>plugin[]</code></td><td style="text-align: left">4 npm plugins</td><td style="text-align: left">Capability extension</td><td style="text-align: left">Cross-machine reuse आसान</td></tr>
<tr><td style="text-align: left"><code>provider.*.options</code></td><td style="text-align: left"><code>baseURL + apiKey</code></td><td style="text-align: left">Provider connection settings</td><td style="text-align: left">Environment variables उपयोग</td></tr>
</tbody></table>
<h2 id="4-default-agent-cx-local-kaa-srot"><a class="zola-anchor" href="#4-default-agent-cx-local-kaa-srot" aria-label="Anchor link for: 4-default-agent-cx-local-kaa-srot"><i class="icon"></i></a>
4. <code>default_agent = cx-local</code> का स्रोत</h2>
<p><code>cx-local</code> को <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a> plugin register करता है; local config में manual <code>agent</code> block की जरूरत नहीं होती।</p>
<p>यह plugin canonical agents देता है: <code>cx-explore</code>, <code>cx-local</code>, <code>cx-global</code>।</p>
<p>प्रभाव:</p>
<ol>
<li>Global config compact रहती है।</li>
<li>Plugin load fail होने पर default agent register नहीं होता।</li>
</ol>
<h2 id="5-plugin-stack-mukhy-bhaag"><a class="zola-anchor" href="#5-plugin-stack-mukhy-bhaag" aria-label="Anchor link for: 5-plugin-stack-mukhy-bhaag"><i class="icon"></i></a>
5. Plugin stack (मुख्य भाग)</h2>
<h3 id="5-1-plugin-list-npm-names"><a class="zola-anchor" href="#5-1-plugin-list-npm-names" aria-label="Anchor link for: 5-1-plugin-list-npm-names"><i class="icon"></i></a>
5.1 Plugin list (npm names)</h3>
<pre class="giallo" style="color: #839496; background-color: #002B36;"><code data-lang="json"><span class="giallo-l"><span style="color: #2AA198;">"plugin"</span><span>: [</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-planpilot"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-workbench"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-web-preview"</span><span>,</span></span>
<span class="giallo-l"><span style="color: #2AA198;"> "opencode-cx-agents"</span></span>
<span class="giallo-l"><span>]</span></span></code></pre>
<p>GitHub repositories:</p>
<ul>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a></li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a></li>
</ul>
<h3 id="5-2-opencode-planpilot"><a class="zola-anchor" href="#5-2-opencode-planpilot" aria-label="Anchor link for: 5-2-opencode-planpilot"><i class="icon"></i></a>
5.2 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a></h3>
<p><strong>भूमिका</strong>: complex tasks के लिए structured execution.<br />
<strong>Core capabilities</strong>:</p>
<ul>
<li>unified model: <code>plan -> step -> goal</code></li>
<li><code>ai / human</code> executor split</li>
<li>next executor <code>ai</code> होने पर auto-continue</li>
</ul>
<p><strong>उपयुक्त परिदृश्य</strong>: multi-stage लंबे tasks जिनमें progress tracking जरूरी हो।</p>
<h3 id="5-3-opencode-workbench"><a class="zola-anchor" href="#5-3-opencode-workbench" aria-label="Anchor link for: 5-3-opencode-workbench"><i class="icon"></i></a>
5.3 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a></h3>
<p><strong>भूमिका</strong>: branch/worktree आधारित parallel orchestration.<br />
<strong>Core capabilities</strong>:</p>
<ul>
<li>session-to-worktree explicit binding</li>
<li>worktree-wise task routing</li>
<li>branch/task context traceability</li>
</ul>
<p><strong>उपयुक्त परिदृश्य</strong>: एक ही repo में parallel task execution.</p>
<h3 id="5-4-opencode-web-preview"><a class="zola-anchor" href="#5-4-opencode-web-preview" aria-label="Anchor link for: 5-4-opencode-web-preview"><i class="icon"></i></a>
5.4 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a></h3>
<p><strong>भूमिका</strong>: local frontend preview session management.<br />
<strong>Core capabilities</strong>:</p>
<ul>
<li>available preview sessions detect करना</li>
<li>local preview host start/stop</li>
<li>preview status check</li>
</ul>
<p><strong>उपयुक्त परिदृश्य</strong>: UI changes की तेज validation.</p>
<h3 id="5-5-opencode-cx-agents"><a class="zola-anchor" href="#5-5-opencode-cx-agents" aria-label="Anchor link for: 5-5-opencode-cx-agents"><i class="icon"></i></a>
5.5 <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-cx-agents"><code>opencode-cx-agents</code></a></h3>
<p><strong>भूमिका</strong>: reusable preset agents और permission baseline प्रदान करना।<br />
<strong>Core capabilities</strong>:</p>
<ul>
<li>canonical agents: <code>cx-explore</code>, <code>cx-local</code>, <code>cx-global</code></li>
<li>write permission tiers:
<ul>
<li><code>cx-local</code>: workspace-first, <code>external_directory: ask</code></li>
<li><code>cx-global</code>: cross-directory writes, <code>external_directory: allow</code></li>
</ul>
</li>
<li><a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-planpilot"><code>opencode-planpilot</code></a>, <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-workbench"><code>opencode-workbench</code></a>, और <a class="external" rel="noopener nofollow noreferrer external" target="_blank" href="https://github.com/canxin121/opencode-web-preview"><code>opencode-web-preview</code></a> के साथ compatible रहते हुए tool visibility बनाए रखना</li>
</ul>
<p><strong>उपयुक्त परिदृश्य</strong>: multiple repos में consistent agent strategy और risk-based write defaults रखना।</p>
<h3 id="5-6-upyog-sujhaav"><a class="zola-anchor" href="#5-6-upyog-sujhaav" aria-label="Anchor link for: 5-6-upyog-sujhaav"><i class="icon"></i></a>
5.6 उपयोग सुझाव</h3>
<ol>
<li>safe default के रूप में <code>default_agent = cx-local</code> रखें।</li>
<li>cross-directory auto-write की स्पष्ट जरूरत हो तभी <code>cx-global</code> चुनें।</li>
<li>startup के बाद <code>cx-explore / cx-local / cx-global</code> visibility verify करें।</li>
</ol>
<h2 id="6-provider-aur-model-routing"><a class="zola-anchor" href="#6-provider-aur-model-routing" aria-label="Anchor link for: 6-provider-aur-model-routing"><i class="icon"></i></a>
6. Provider और model routing</h2>
<p>वर्तमान layout: एक gateway domain, provider-specific routes.</p>
<table><thead><tr><th style="text-align: left">Provider</th><th style="text-align: left">baseURL</th><th style="text-align: left">विवरण</th></tr></thead><tbody>
<tr><td style="text-align: left"><code>anthropic</code></td><td style="text-align: left"><code>https://gateway.example.com/v1</code></td><td style="text-align: left">Anthropic-compatible route</td></tr>
<tr><td style="text-align: left"><code>google</code></td><td style="text-align: left"><code>https://gateway.example.com/v1beta</code></td><td style="text-align: left">Gemini-compatible route</td></tr>
<tr><td style="text-align: left"><code>openai</code></td><td style="text-align: left"><code>https://gateway.example.com/v1</code></td><td style="text-align: left">OpenAI-compatible route</td></tr>
</tbody></table>