Upgraded OpenCode Stack

⚠️ GitNexus-Pflicht: Bevor du Code in diesem Repo änderst, MUSST du gitnexus_impact() (Blast Radius) and gitnexus_detect_changes() (vor Commit) ausführen. Siehe GitNexus Guide.

Quick Start · Features · Architecture · Skills · Commands · Providers · Troubleshooting · Deploy · Contributing · 🚫 BANNED

Clone. Install. Run. Dein komplettes OpenCode-Setup — auf jedem Mac identisch.

---

Quick Start

1. Clone git clone OpenSIN-Code/Infra-SIN-OpenCode-Stack

2. Install ./install.sh

3. Run opencode run "hello"

Tip

Danach .env mit deinen API Keys befuellen — fertig. Exakt dasselbe Setup wie auf deinem Haupt-Mac.

---

Using Qwen Provider

Qwen OAuth (via opencode-qwen-auth plugin) provides free daily quota (~1000 requests) and multi-account rotation.

Quick Setup (for members)

1. Ensure plugin is installed (the installer does this automatically):

   opencode providers list | grep qwen
   # Should show: qwen (oauth) with 0 credentials initially

2. Add your Qwen account:

   opencode /connect

   • Select Provider: qwen
   • Select Method: Qwen OAuth
   • Follow device flow: open https://chat.qwen.ai/ ... enter device code
   • Complete authorization

3. Verify account added:

   opencode providers list | grep qwen -A5
   # Should show: X credentials

4. Select Qwen model:

   /model qwen/coder-model
   

5. Start coding — plugin automatically rotates accounts on rate limits/quota exhaustion.

Managing Multiple Accounts

Add more accounts by repeating /connect. The plugin supports:

• Hybrid rotation (default): Smart selection based on health scores, token bucket, and LRU freshness
• Round-robin: qwen.json: {"rotation_strategy": "round-robin"}
• Sequential: Uses one account until rate limited, then switches

Configuration file (.opencode/qwen.json or ~/.config/opencode/qwen.json):

{
  "rotation_strategy": "hybrid",
  "proactive_refresh": true,
  "max_rate_limit_wait_seconds": 300,
  "quiet_mode": true
}

Troubleshooting

Provider fehlen auf neuem Mac? Siehe docs/troubleshooting/providers-missing.md

🔴 KRITISCH — OpenCode crash bei Start / erster Nachricht:

TypeError: undefined is not an object (evaluating 'n._zod.def')

• Ursache: Zod v3/v4 Konflikt durch gebannte Plugins (oh-my-opencode, opencode-antigravity-auth, opencode-openrouter-auth, opencode-qwen-auth)
• Fix: Siehe banned.md — komplette Wiederherstellung in 2 Minuten

"Qwen not responding" / empty responses:

• Check quota exhaustion: insufficient_quota means free tier depleted (resets at UTC midnight)
• Plugin now correctly treats quota errors as failures (BUG-QWEN-003 fixed)
• If you added a new account via /connect but it's not visible to the plugin, run:

  python3 /Users/jeremy/dev/docs/opencode/sync-qwen-credentials.py --verbose

View active account:

cat ~/.config/opencode/qwen-auth-accounts.json | grep email

Reset plugin state:

rm ~/.config/opencode/qwen-auth-accounts.json
# Then re-add accounts via /connect

For full documentation, see the plugin README:
/Users/jeremy/dev/Infra-SIN-OpenCode-Stack/local-plugins/opencode-qwen-auth/README.md

---

Features

Capability	Description	Status
Global-Brain (DPMA v4)	Multi-Project Memory — Agenten vergessen nie wieder was sie gelernt haben	✅
Local-Brain / GraphRAG	Projekt-basiertes Plan-Gedächtnis mit Auto-Invalidation	✅
OMOC Swarm	5-Agenten-Schwarm (Atlas, Hephaestus, Metis, Momus, Prometheus)	✅
SIN-Zeus Fleet Commander	GitHub Projects, Issues, Branches + Hermes Dispatch	✅
52 Skills	A2A Agent Builder, Deploy, Debug, Browser Automation, Image/Video Gen	✅
9 Plugins	OMOC Swarm, RTK Token Optimizer, Image Gen Bypass, Neural Bus Memory	✅
31 MCP Servers	sin-telegrambot, sin-google-apps, sin-terminal, simone-mcp, gitnexus...	✅
12 Custom Commands	Swarm orchestration, Terminal orchestration, Zeus bootstrap	✅
6 Provider	Fireworks AI (SIN), Google Antigravity, OpenAI, OpenRouter, Qwen, Modal	✅
sin-sync Fleet Sync	Mac → OCI VM → HF VM — identische Configs überall	✅
System Directive Watcher	LaunchAgent-Wrapper + stale-PID Guard für dauerhaften Auto-Start	✅
Box.com Storage	Unlimited cloud storage via A2A-SIN-Box-Storage (10GB free + auto-scale)	✅

Full Tool Surface — Alle Komponenten im Detail

Skills (52)

3d-web, anonymous, awesome-opensin-design, browser-crashtest-lab, check-my-dev-in-web, check-plan-done, cloudflare-deploy, create-a2a, create-a2a-mcp, create-a2a-sin-agent, create-a2a-sin-coder, create-a2a-team, create-auth-plugin, create-flow, create-github-account, create-github-app, create-hf-space-vm, create-telegrambot, doc, doctor, docx, enterprise-deep-debug, enterprise-parallel-exploration, gen-image, gen-thumb, gen-thumbnail, gen-veo, gitlab-storage, imagegen, new-google-login, nvidia-3d-forge, nvidia-video-forge, omoc-plan-swarm, opencode-subagent-delegation, pdf, plan, preview, self-healer, seo-import, sin-a2a-agent-forge, sin-bridge, sin-vision-colab, sora, sovereign-repo-governance, sovereign-research, stealth-browser-operator, survey-runner, thumbnail-optimizer, undelete-login-google, vercel-deploy, video-check, visual-repo

Plugins (9)

Core (plugins/): omoc-swarm.ts (Swarm Orchestration), rtk.ts (Token Optimizer), registry.ts, state.ts

Local (local-plugins/): opencode-bypass-v2 (Image Gen Engine), opencode-flux-bypass (Flux Free), opencode-ideogram-free (Ideogram Free), ouroboros-context (Neural Bus Memory), gitlab-storage (deprecated)

MCP Servers (31)

Aktiv: sin-document-forge, sin-telegrambot, sin-google-apps, sin-server, sin-cloudflare, sin-passwordmanager, sin-research, sin-team-worker, sin-tiktok, sin-tiktok-shop, sin-terminal, sin-authenticator, sin-github-issues, sin-oraclecloud-mcp, n8n-workflow-builder, sin-google-docs, sin-summary, sin-paragraph, simone-mcp, opencode-bypass-v2, sin-brain, sin-preview, gitnexus, ai-memory

Inaktiv: tavily, canva, context7, chrome-devtools, linear, singularity, sin-neural-bus, firecrawl

(back to top)

---

Architecture

flowchart TB
    subgraph Clients["Clients"]
        OC[OpenCode CLI]
        AG[A2A Agents]
        SK[Custom Skills]
    end

    subgraph Transport["Transport Layer"]
        STD[MCP stdio]
        HTTP[HTTP/MCP]
    end

    subgraph Core["Core Stack"]
        CFG[opencode.json]
        PLG[5 Plugins]
        AGT[21 Agents]
    end

    subgraph Storage["Storage"]
        BO[Box.com Storage]
        DP[DPMA v4 Brain]
    end

    subgraph Fleet["Fleet"]
        MAC[Mac]
        OCI[OCI VM]
        HF[HF VMs]
    end

    OC --> STD
    AG --> HTTP
    SK --> STD
    STD --> CFG
    HTTP --> CFG
    CFG --> PLG
    CFG --> AGT
    PLG --> BO
    AGT --> DP
    CFG --> SYNC[sin-sync]
    SYNC --> MAC
    SYNC --> OCI
    SYNC --> HF

    classDef clientClass fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    classDef transportClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
    classDef coreClass fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    classDef storageClass fill:#fce4ec,stroke:#880e4f,stroke-width:2px
    classDef fleetClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px

    class OC,AG,SK clientClass
    class STD,HTTP transportClass
    class CFG,PLG,AGT coreClass
    class GL,DP storageClass
    class MAC,OCI,HF fleetClass

Loading

For detailed architecture documentation see docs/oci-vm-architecture.md, FIXES_2026-04-11.md, and docs/operations/system-directives-guide.md (System Directives & Brain Sync Enforcer).

Important

Der Canonical Watcher-Stack läuft über ~/.config/opencode/scripts/launch-watcher.sh und ~/Library/LaunchAgents/org.opencode.system-directive-watcher.plist. Der Antigravity-Token-Refresh-Service bleibt absichtlich nicht auto-startend (RunAtLoad=false, KeepAlive=false).

(back to top)

---

Skills

Skill	Zweck
create-a2a	A2A Agent erstellen
create-a2a-mcp	A2A MCP Server erstellen
create-a2a-sin-coder	A2A Coder Agent bootstrappen
create-a2a-team	SIN A2A Team Manager erstellen
create-auth-plugin	OpenCode Auth Plugin bauen
create-flow	Interaktiver Flow Builder (SIN-InkogniFlow)
new-google-login	Robustes Google-Login via Chrome-CDP
create-telegrambot	Telegram Bot erstellen/deployen
cloudflare-deploy	Cloudflare Deployment
vercel-deploy	Vercel Deployment
sin-bridge	OpenSIN Bridge Chrome Extension
enterprise-deep-debug	Enterprise Debugging
sovereign-repo-governance	Repo Governance
anonymous	Browser Automation (skylight-cli-mcp)
imagegen	Bild-Generierung via Gemini
nvidia-video-forge	Video-Generierung via NVIDIA
survey-runner	Survey-Automation für heypiggy.com (NEMO)

Vollständige Liste: 45 Skills verfügbar

---

Commands

Command	Zweck
omoc-jam	Collaborative Swarm Jam
omoc-max	OMOC MAX best-of-n
omoc-status	Swarm Members anzeigen
sin-terminal-orchestrate	SIN-Terminal — parallele Sessions steuern
sin-zeus-bootstrap	GitHub Project + Issue Pool aus Zeus Plan

Alle 13 Commands

Command	Zweck
omoc-swarm-create	Swarm erstellen/registrieren
omoc-swarm-discover	Swarm aus Session-Titeln entdecken
omoc-jam	Collaborative Swarm Jam
omoc-max	OMOC MAX best-of-n
omoc-status	Swarm Members anzeigen
omoc-autostart	Auto-bind Swarm + JAM Guidance
sin-terminal-orchestrate	SIN-Terminal — parallele Sessions steuern
sin-terminal-orchestrate-status	Terminal Orchestration Status
sin-terminal-orchestrate-delegate	Follow-up Prompt delegieren
sin-terminal-orchestrate-stop	Alle Sessions stoppen
sin-zeus-bootstrap	GitHub Project + Issue Pool aus Zeus Plan
sin-zeus-hermes	Hermes Dispatch Payloads generieren
sin-zeus-status	Zeus Control-Plane Status

---

Providers

Provider	Modelle
fireworks-ai (SIN)	DeepSeek V4 Pro (SIN), Kimi K2.6 (SIN), Qwen3.6 Plus (SIN), GLM 5.1 (SIN), MiniMax M2.7 (SIN) — alle mit thinking Variants
vercel-pool (SIN)	MiniMax M3 (1M, vision+pdf), Grok Build 0.1 (256K, coding), Grok 4.3 (1M, flagship), Nano Banana 2 / Gemini 3.1 Flash Image (T2I/I2I/Edit)
google (Antigravity)	Claude Sonnet 4.6, Claude Opus 4.6, Gemini 3.1 Pro, Gemini 3 Flash
openai	GPT-5.4, GPT-5.4-mini via OCI Proxy (92.5.60.87:4100)
openrouter	Qwen 3.6 Plus, DeepSeek V3/R1, Gemini 2.5 Flash, Llama 4 Maverick, Phi-4 (free)
qwen	Qwen 3.6 Plus (OAuth, ~2000/day free)
omniroute	105 Modelle via AgentRouter + OpenAI API — Auto-Routing (best-coding/reasoning/fast), Claude Opus/Sonnet, DeepSeek V3.2, Gemini, Grok, Qwen, GLM
modal	GLM-5.1 FP8 via OCI Token Pool

🖼️ Image Generation

SIN-Image-Generator Agent mit vercel-pool/nano-banana-2 (Gemini 3.1 Flash Image / Nano Banana 2):

opencode run "Generate a minimalist logo for SIN-Lab, blue gradient, vector style" \
  --agent SIN-Image-Generator

Capabilities: Text→Image · Image→Image · Multi-Turn-Edit · 14 Reference-Images · 512/1K/2K/4K Pricing: $0.045/0.5K · $0.067/1K · $0.101/2K · $0.151/4K pro Bild Setup: siehe INSTALL.md

---

---

Deploy

Methode	Kommando	Zweck
Local	./install.sh	Mac Setup — 1:1 Kopie des Setups
OCI VM	sin-sync	Config Sync Mac → OCI VM (92.5.60.87)
HF VM	sin-sync	Config Sync Mac → HF Spaces
Lightning AI	sin-sync	Config Sync Mac → Lightning AI VM

Important

sin-sync muss nach JEDER Aenderung an opencode.json ausgefuehrt werden. Auth-Dateien werden automatisch ausgeschlossen.

Environment Variables

Variable	Purpose	Required
NVIDIA_API_KEY	NVIDIA NIM	✅
GOOGLE_API_KEY	Gemini Direct API	✅
OPENROUTER_API_KEY	OpenRouter	✅
OPENAI_API_KEY	OpenAI (via Proxy)	✅
TELEGRAM_BOT_TOKEN	sin-telegrambot
N8N_BASE_URL	n8n URL
N8N_API_KEY	n8n API Key
OCI_VM_HOST	OCI VM Host
OCI_VM_USER	OCI VM User
SUPABASE_URL	Supabase
SUPABASE_KEY	Supabase Key

(back to top)

---

Externe Integrationen

Übersicht aller im Stack integrierten Open-Source-Projekte und Tools. Vollständige Details: docs/EXTERNAL_INTEGRATIONS.md

Projekt	Typ	Zweck
RTK	Token Optimizer	Shell-Commands 60-90% Token-Ersparnis
@ai-sdk/fireworks	AI SDK	Fireworks AI Provider für OpenCode
GitNexus	Code Intelligence	Knowledge Graph (14k+ Nodes)
n8n	Workflow Automation	Indestructible Router (OCI VM)
Simone-MCP	Code Analyse	LSP Semantic Ops (40+ Languages)
Global Brain	Memory System	DPMA v4 Multi-Project Memory
nodriver	Browser Automation	Chrome ohne WebDriver
Supabase	Database	PostgreSQL + pgvector (OCI)
Box.com	Cloud Storage	10GB Free + Auto-Scale
Cloudflare	Deployment	Pages, Workers, R2, DNS
Hugging Face	VM Hosting	Free Spaces VM
Lightning AI	GPU VM	ML Workloads
Tavily	Search API	AI-optimierte Suche
Firecrawl	Web Scraping	Crawling-as-API

(back to top)

---

Repo Struktur

Infra-SIN-OpenCode-Stack/
├── install.sh              # Haupt-Installer
├── opencode.json           # OpenCode Config (Provider, Modelle, MCPs, Agenten)
├── AGENTS.md               # Globale Agent-Regeln (inkl. PARALLEL-EXPLORATION MANDATE)
│
├── oh-my-sin.json          # 🆕 Zentrales A2A Team Register (alle Teams + Manager)
├── oh-my-openagent.json    # Subagenten-Modell-Konfiguration (explore, librarian, etc.)
├── oh-my-openagent.json     # Identisch mit oh-my-openagent.json (gesynced)
├── my-sin-team-code.json   # 🆕 Team Coding Agenten + Modelle
├── my-sin-team-worker.json # 🆕 Team Worker Agenten + Modelle
├── my-sin-team-infrastructure.json # 🆕 Team Infra Agenten + Modelle
│
├── .env.example            # API Key Template
├── llms.txt                # AI Discoverability
├── llms-full.txt           # Full Context for AI Agents
├── CONTRIBUTING.md         # How to contribute
├── SECURITY.md             # Security policy
├── SUPPORT.md              # Where to get help
├── bin/                    # 11 CLI Tools
├── skills/ # 40+ Skills (plan v2, grill-me, self-review, dodone, pipeline, etc.)
├── plugins/                # 5+ Plugins (lokal)
├── agents/                 # Agent-Definitionen
├── commands/               # 14 Custom Commands (/pipeline, /dodone, /scan, etc.)
├── scripts/                # 17 Scripts
├── docs/                   # OCI VM Architecture + Fixes
├── hooks/                  # Git Hooks
├── templates/              # JSON Schemas
└── vendor/                 # Vendored Dependencies

---

Agenten-Konfigurationsdateien

Dieses Repo verwaltet Konfigurationsdateien für die gesamte A2A-Flotte:

Datei	Zweck	Inhalt
opencode.json	Haupt-Config — Provider, Modelle, MCPs, Agenten, Commands	Deine sichtbaren Agenten (SIN-Zeus, coder-sin-swarm, etc.)
my-sin-team-code.json	Team Coding — Entwickler-Flotte	Zeus, Simone, Frontend, Backend, Fullstack
my-sin-team-worker.json	Team Worker — autonome Worker	Prolific, Freelancer, Survey
my-sin-team-infrastructure.json	Team Infra — DevOps-Flotte	Deploy, Monitoring, Security

⚠️ oh-my-openagent.json und oh-my-opencode sind BANNED (Zod v4 Crash). Siehe banned.md.

PARALLEL-EXPLORATION MANDATE

Bei grossen Codebases (100k+ Zeilen) MUESSEN Agenten 5-10 parallele explore + 5-10 librarian-Agenten starten:

task(subagent_type="explore", run_in_background=true, load_skills=[], description="Find APIs", ...)
task(subagent_type="explore", run_in_background=true, load_skills=[], description="Find Services", ...)
task(subagent_type="librarian", run_in_background=true, load_skills=[], description="Framework Docs", ...)
// ... 9 weitere parallele Agenten

Siehe AGENTS.md → PARALLEL-EXPLORATION MANDATE (PRIORITY -4.5) fuer Details.

---

Changelog

v2.2.2 (2026-04-16)

• System Directive Watcher — canonical LaunchAgent now uses launch-watcher.sh with stale-PID command-line verification
• Token-Refresh-Service Safety — com.antigravity.Token-Refresh-Service.plist kept non-autostarting on purpose; no automatic trigger path
• Docs Sync — README + system-directives guide aligned with the current global watcher runtime

v2.2.1 (2026-04-14)

• Box.com Storage — Replaced deprecated GitLab LogCenter with A2A-SIN-Box-Storage service
• Updated storage default globally in AGENTS.md (Box Storage Mandate)
• Added box_storage.py compatibility layer, deprecated gitlab_logcenter.py
• Updated Infra-SIN-Docker-Empire: room-09-box-storage added, room-07-gitlab-storage removed
• All agents must migrate to Box Storage API before 2026-05-01

v2.2.0 (2026-04-14)

• Step 3.5 Flash — explore/librarian nutzen jetzt nvidia-nim/stepfun-ai/step-3.5-flash
• PARALLEL-EXPLORATION MANDATE — 5-10 parallele explores fuer grosse Codebases
• Full Fallback Chains — restored fuer explore/librarian (6 Modelle pro Agent)
• Providers aktualisiert — glm-5.1-fp8, gpt-5.4-mini, qwen-3.5-flash, Lightning AI VM

v2.1.0 (2026-04-14)

• Enterprise Visual README overhaul (badges, diagrams, llms.txt)
• GitLab Storage skill added (infinite storage via auto-rotating repos) - NOW DEPRECATED
• OCI VM architecture documented
• .so temp file leak root cause fixed + systemd timer added
• Vision model removed from Qwen config (no longer supported)
• reasoningEffort removed from all Qwen agents (not supported)

v2.0.0 (2026-04-12)

• Qwen OAuth plugin fully fixed and integrated
• Global-Brain DPMA v4 hooks installed

v1.0.0 (2026-04-11)

• Initial release
• 29 Skills, 5 Plugins, 21 Agents, 11 CLI Tools

---

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run ./install.sh to verify
5. Commit (git commit -m 'Add amazing feature')
6. Push (git push origin feature/amazing-feature)
7. Open a Pull Request

Note

Nach jeder Aenderung an opencode.json MUSS sin-sync ausgefuehrt werden.

---

License

MIT. See LICENSE for details.

---

_{Built by OpenSIN-AI Fleet}

(back to top)