OpenCommand

OpenCommand is één OpenCode/NPM-plugin voor CommandCode. De plugin registreert de provider opencommand, start lokaal een OpenAI-compatible proxy en bundelt die proxy-binaries zelf in het NPM-package.

Er is dus geen losse proxy-installatie of lokale repo-checkout meer nodig in OpenCode. De Go-code staat nog wel in proxy/, maar alleen als broncode: bij npm run build:proxy worden de binaries naar dist/proxy/ gebouwd en met opencommand-plugin gepubliceerd.

Huidige structuur

.
├── bin/opencode-plugin.js        # OpenCode plugin entrypoint
├── bin/opencommand-jcode.js       # standalone JCode/OpenAI-client CLI
├── src/index.ts                  # plugin runtime/provider/proxy manager
├── proxy/                        # Go source voor de lokale proxy
├── scripts/build-proxy-binaries.mjs
├── tests/                        # Jest tests voor plugin/runtime
├── package.json                  # NPM package: opencommand-plugin
└── dist/                         # build output, niet getrackt

Gebruik met OpenCode

Gebruik na publicatie:

{
  "plugin": ["opencommand-plugin@latest"],
  "model": "opencommand/deepseek/deepseek-v4-flash",
  "small_model": "opencommand/deepseek/deepseek-v4-flash",
}

Voor een vaste versie kun je een specifieke versie pinnen, bijvoorbeeld [email protected].

Bij OpenCode-start doet de plugin dit automatisch:

1. kiest de juiste gebundelde proxybinary voor macOS/Linux/Windows;
2. start de proxy in de achtergrond op een lokale poort (OpenCode wacht daar niet op);
3. schrijft ~/.opencommand/proxy-config.json met de actieve URL;
4. registreert provider opencommand met http://localhost:<port>/v1;
5. detecteert het actieve CommandCode-plan en registreert de bijpassende modellen (alle netwerkcalls met korte timeouts).

OpenCode moet opnieuw worden gestart nadat opencode.jsonc of de pluginversie is gewijzigd, want plugin-config wordt bij startup geladen.

Gebruik met omp (oh-my-pi)

Installeer het package als omp-plugin; de gebundelde extensie start de proxy en registreert automatisch de opencommand-provider met je plan-modellen:

omp plugin install [email protected]

De extensie wordt geladen via het omp.extensions-veld in package.json. Zorg dat je CommandCode-token bekend is (env COMMAND_CODE_TOKEN of ~/.opencommand/opencommand-secrets.json). Kies daarna een model, bv. opencommand/deepseek/deepseek-v4-pro. Getest met omp 17.x.

Gebruik met Pi (pi-mono)

pi install npm:[email protected]

Pi laadt hetzelfde entrypoint via het pi.extensions-veld. Dezelfde token-resolutie geldt. Getest met pi 0.79.x (Authorization: Bearer bevestigd).

JCode en andere standalone OpenAI-clients

Start de gebundelde proxy in de voorgrond; dit is het enige npm-commando voor de standalone route (er bestaat geen opencommand-proxy executable):

COMMAND_CODE_TOKEN=user_xxx npx --yes --package=opencommand-plugin opencommand-jcode

De CLI print de werkelijke loopback /v1-URL. Configureer JCode als OpenAI-compatible client met precies die URL en kies een model uit de geprinte /v1/models-route. Sla geen CommandCode-token op in JCode-configuratie op.

De standalone proxy heeft bewust geen client-key, zodat een ephemeral key niet in JCode hoeft te staan. Hij bindt alleen op loopback, maar elk lokaal proces kan daardoor wel de proxy en jouw credits gebruiken zolang hij draait.

Zero data retention (ZDR)

Net als de CommandCode CLI ondersteunt OpenCommand CMD_ZDR=1: start OpenCode met CMD_ZDR=1 opencode en de plugin/proxy sturen op elke request de x-cmd-zdr: 1-header mee, waarmee upstream zero data retention en geen prompt-training wordt afgedwongen. Modellen zonder ZDR-upstream geven dan een CMD_ZDR_NO_PROVIDERS-fout terug; kies in dat geval een ander model of zet CMD_ZDR uit.

Auth-model

Gebruik primair een CommandCode token (user_...). Zet secrets niet in gesyncte opencode.jsonc.

Prioriteit:

1. inkomende Authorization: Bearer user_... requests;
2. COMMAND_CODE_TOKEN;
3. alias COMMANDCODE_API_KEY;
4. lokale secret ~/.opencommand/opencommand-secrets.json met sleutel opencommand.command_code_token.

Voorbeeld:

{
  "opencommand.command_code_token": "user_xxx..."
}

De plugin maakt ~/.opencommand met 0700 permissies en schrijft secrets met 0600. CC_SESSION_COOKIE is alleen bedoeld voor CommandCode Studio usage scraping, niet als primaire model-auth.

Lokale bestanden

OpenCommand gebruikt alleen lokale bestanden buiten de repo:

• ~/.opencommand/opencommand-secrets.json — CommandCode token en optionele Studio-cookie.
• ~/.opencommand/proxy-config.json — actieve proxy URL/poort van een plugin-host; de JCode-CLI leest of schrijft dit niet.
• ~/.opencommand/model-cache.json — laatst bekende plan/model-lijst.

Voorbeeld proxy-config.json:

{
  "url": "http://localhost:3000",
  "port": 3000,
  "updatedAt": "2026-05-19T20:00:00.000Z"
}

Browser-cookie extractie

Voor usage scraping kan de plugin proberen een CommandCode Studio-cookie te vinden in lokale browserprofielen:

• macOS: Chrome, Comet, Brave, Edge en Firefox.
• Linux: Chrome, Chromium, Brave, Edge en Firefox.
• Windows: Chrome, Chromium, Brave, Edge en Firefox.

Linux en Windows hebben hiervoor een sqlite3 CLI nodig om browser-cookie databases te lezen. Zet op Windows OPENCOMMAND_SQLITE_PATH naar sqlite3.exe als sqlite niet op je PATH staat.

Gevonden cookies worden lokaal opgeslagen als:

{
  "opencommand.cc_session_cookie": "..."
}

Cookie-waarden worden niet gelogd en niet in opencode.jsonc opgeslagen.

Model-detectie per plan

De proxy/plugin vraagt /alpha/billing/subscriptions op en filtert modellen per plan:

• individual-go: open-source modellen, inclusief de ongegate premium-tier modellen die CommandCode als opensource categoriseert (momenteel o.a. Grok 4.5 en Kimi K3 — "available on every plan, including Go").
• individual-pro: open-source + premium, zonder Opus en zonder de per-plan geblokkeerde modellen (claude-fable-5, sakana/fugu-ultra).
• individual-provider, individual-max, individual-ultra, teams-pro: open-source + premium inclusief Opus.

De plan-regels (inclusief blockedModels) staan in model-definitions/commandcode-plans.json en worden meegegenereerd naar TS en Go.

Als plan-detectie faalt, valt OpenCommand terug op de lokale cached/static Go/open-source lijst zodat OpenCode alsnog kan starten.

De statische modelcatalogus staat in model-definitions/commandcode-models.json. npm run generate:models genereert hieruit (plus commandcode-plans.json en commandcode-protocol.json) de TypeScript- en Go-runtimebestanden, zodat plugin en proxy dezelfde modeldefinities, plan-regels en protocolversie gebruiken.

Upstream bijwerken: npm run bump:commandcode

Eén bewust commando werkt alle gebundelde CommandCode-data bij:

1. Protocolversie — laatste CLI-versie via de npm-registry (command-code).
2. Modelcatalogus — merge met de live provider-API; gecureerde velden (cost, output, category, reasoning) blijven behouden, nieuwe/verdwenen modellen worden gemeld.
3. Prijzen — gescraped van de pricing-docs-pagina (doorgestreepte oude prijzen worden genegeerd).

Het script schrijft alleen de werkkopie; reviewen en committen blijft handwerk. De publish-workflow draait dezelfde check als gate: een release faalt zolang de gebundelde data achterloopt. De plugin waarschuwt daarnaast bij het starten (max. één registry-call per dag, cache in ~/.opencommand/version-check.json) als de gebundelde protocolversie achterloopt.

Voor tests/CI zijn de bronnen overridebaar via OPENCOMMAND_BUMP_REGISTRY_URL, OPENCOMMAND_BUMP_MODELS_URL, OPENCOMMAND_BUMP_PRICING_URL, OPENCOMMAND_BUMP_ROOT en OPENCOMMAND_BUMP_SKIP_GENERATE=1.

Lokale API

De proxy biedt OpenAI-compatible endpoints:

• POST /v1/chat/completions — streaming en non-streaming chat completions (image-parts geven een 400; de proxy ondersteunt nog geen beeldinvoer).
• GET /v1/models — plan-gefilterde model-lijst; live gemerged met de upstream provider-API (cache 10 min, offline fallback naar de gebundelde catalogus; uitzetten kan met OPENCOMMAND_LIVE_MODELS=0).
• GET /v1/models/allowed — CommandCode Studio allowed-models/usage info.
• GET /v1/account/usage — usage summary.
• GET /v1/status — diagnose zonder secrets: protocolversie, gedetecteerd plan, ZDR-stand, modelcount, live-catalogus-status.

Client-authenticatie

De plugin genereert per proxystart een client-key en geeft die via OPENCOMMAND_PROXY_KEY aan de proxy; alle /v1/*-endpoints eisen dan die key, een user_...-token of de geconfigureerde CommandCode-token (/healthz blijft open). Zo kan een willekeurig lokaal proces de poort niet gebruiken om credits te verbruiken. De key staat alleen in het procesgeheugen, nooit in logs of proxy-config.json. Een handmatig gestarte proxy zonder OPENCOMMAND_PROXY_KEY gedraagt zich als voorheen (open op localhost).

• GET /healthz — health check.

De proxy vertaalt OpenAI messages, tools, tool_choice en streaming responses naar/van het huidige CommandCode CLI-protocol.

Development

Root package:

npm ci
npm run generate:models
npm test -- --runInBand
npm run build
npm run build:proxy
npm pack --dry-run

Go proxy tests:

cd proxy
go vet ./...
go test -race ./...
go build -o proxy .

npm pack bevat alleen de runtimebestanden:

• README.md
• package.json
• bin/opencode-plugin.js
• bin/opencommand-jcode.js
• dist/index.js
• dist/index.d.ts
• dist/proxy/opencommand-proxy-*

De bronmappen src/, tests/ en proxy/ worden niet gepubliceerd in het NPM-package.

Publicatie

Package: opencommand-plugin.

De publish workflow staat in .github/workflows/npm-publish.yml. Deze workflow bouwt/test de root package, bouwt de proxybinaries en controleert dat alle vereiste bestanden in het NPM-package zitten.

Release notes

v0.0.27

• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.14.1; modelcatalogus en prijzen gesynchroniseerd met upstream.
• Nieuwe modellen meta/muse-spark-1.2 en meta/muse-spark-1.2-contributor toegevoegd; Muse Spark 1.2 krijgt gecureerde context/prijzen uit de live pricing.

v0.0.26

• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.13.0; modelcatalogus en prijzen gesynchroniseerd met upstream (DeepSeek V4 Flash hernoemd, Qwen3.8-Max met upstream-curation, inclusionai/ling-3.0-flash-free verwijderd).
• Nieuwe plannen uit CLI 1.13.0: individual-goat (opensource-modellen) en individual-pro-v1 (premium met dezelfde blokkades als Pro); Pro-v1-gebruikers kregen voorheen per ongeluk alleen de Go-modellijst.
• Lint: .worktrees/ en .superpowers/ genegeerd door eslint/prettier; twee ongeformatte bestanden alsnog gefixt zodat npm run lint in CI en lokaal groen is.

v0.0.25

• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.9.0; modelcatalogus en prijzen gesynchroniseerd met upstream.
• Nieuw scripts/auto-sync-commandcode-release.mjs: end-to-end release-pipeline (bump, versie, tests, commit, publish).

v0.0.24

• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.6.0; modelcatalogus en prijzen gesynchroniseerd met upstream, inclusief Inkling Small.

v0.0.23

• Nieuw opencommand-jcode npm-commando start de gebundelde loopback-proxy voor JCode en andere standalone OpenAI-clients, zonder token of ephemeral proxy-key in clientconfiguratie op te slaan.
• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.5.0; modelcatalogus en prijzen gesynchroniseerd met upstream.

v0.0.22

• Gebundelde CommandCode-protocolversie bijgewerkt naar 1.2.0; modelcatalogus en prijzen gesynchroniseerd met upstream.
• Nieuwe modellen: Gemini 3.6 Flash, Gemini 3.5 Flash Lite, Laguna S 2.1 en Ling 3.0 Flash; Tencent Hy3 verwijderd omdat upstream het niet langer aanbiedt.

v0.0.19

• Proxy /v1/models merget nu live met de upstream provider-API (10 min cache, offline fallback naar de gebundelde catalogus): nieuwe modellen zijn zichtbaar zonder plugin-release.
• Nieuw GET /v1/status-endpoint: protocolversie, gedetecteerd plan, ZDR-stand, modelcount en live-catalogus-status voor debugging.
• Proxy-client-auth: per start een key via OPENCOMMAND_PROXY_KEY; lokale processen zonder key/token krijgen 401 op /v1/*.
• Modelcache is token-gebonden (sha256-hash) en wordt atomair geschreven; na een tokenwissel geen modellen van het vorige plan meer.
• De proxy stopt mee met OpenCode (parent-exit-hook) en proxy-config.json bevat het eigenaar-PID; image-parts in chat-requests geven een duidelijke 400 in plaats van stil te verdwijnen.
• Zero data retention: CMD_ZDR=1 stuurt (net als de CommandCode CLI) x-cmd-zdr: 1 mee op elke upstream-request.
• Snellere OpenCode-start: proxystart gebeurt in de achtergrond, alle startup-netwerkcalls hebben korte timeouts, en de model/plan-fetch wordt niet langer dubbel uitgevoerd; de versie-drift-waarschuwing wordt nu daadwerkelijk bij start gedraaid.
• Plan-gating volgt upstream: nieuw plan individual-provider; per-plan blockedModels (Pro krijgt geen claude-fable-5/sakana/fugu-ultra meer); Grok 4.5 en Kimi K3 zijn als opensource beschikbaar, ook op het Go-plan.
• Modelcatalogus gesynchroniseerd met CLI 0.51.0: Claude Sonnet 5, GPT-5.6 Sol/Terra/Luna, Kimi K3, Tencent Hy3 (tijdelijk gratis), Inkling, Muse Spark 1.1 en Grok 4.5, inclusief actuele prijzen; sakana/fugu-ultra en meta/muse-spark-1.1 zijn nu premium.
• Tooling: npm run lint (eslint + prettier), CI draait lint, go vet en een gofmt-check; PR-review-diff bevat geen lockfile/generated files meer.
• Ook opgenomen (ongereleased 0.0.18): prettier-reformat, OPENCOMMAND_PROXY_BASE_URL-override.

v0.0.17

• Proxy bindt alleen nog op 127.0.0.1 (was: alle netwerkinterfaces) en alle plugin-URLs gebruiken 127.0.0.1.
• Lange streams worden niet meer na 120 seconden afgebroken; upstream-requests volgen de client-context.
• Gecrashte of ontbrekende proxy wordt gedetecteerd: snelle foutmelding bij start en automatische herstart bij het volgende verzoek.
• Verlopen Studio-cookie wordt bij start gevalideerd en zo nodig opnieuw uit de browser geëxtraheerd.
• Plan-regels en protocolversie worden gegenereerd uit model-definitions/ (één bron voor TS en Go); plan-cache is per token.
• Nieuw: npm run bump:commandcode werkt protocolversie, modelcatalogus en prijzen bij vanuit upstream; de publish-workflow dwingt dit af via een drift-gate en de plugin waarschuwt bij start als de gebundelde versie achterloopt.
• CommandCode protocol headers bijgewerkt naar CLI-versie 0.36.0; modelcatalogus gesynchroniseerd (o.a. Claude Fable 5, Claude Opus 4.8, Gemini 3.5 Flash; claude-opus-4-6 vervallen) inclusief actuele prijzen.
• Security/hygiëne: ~/.opencommand op 0700 en config/cache-bestanden op 0600; CI controleert coverage, npm-package-inhoud, plugin-export en actualiteit van generated files.

v0.0.16

• MiniMax M3 (MiniMaxAI/MiniMax-M3) toegevoegd aan de open-source/Go-plan modellen.
• Qwen 3.7 Max (Qwen/Qwen3.7-Max) toegevoegd aan de open-source/Go-plan modellen.
• CommandCode protocol headers bijgewerkt naar CLI-versie 0.27.0.

v0.0.12

• OpenAI-compatible chat schema voor OpenCode requests.
• Deterministische samenvoeging van system/developer messages naar params.system.
• Conversie van OpenAI tool calls/results naar CommandCode tool-call/tool-result parts.
• Conversie van OpenAI tools en tool_choice naar CommandCode tool schema.
• Fixes voor CommandCode 400-errors rond params.messages[0].role, string content en params.tools[0].name.
• Repo-layout opgeschoond: root is nu het NPM/OpenCode package; proxy/ is alleen Go-source voor bundled binaries.

v0.0.11

• NPM-package bundelt proxybinaries voor macOS, Linux en Windows.
• OpenCode heeft alleen opencommand-plugin nodig; geen losse proxy-installatie.
• Proxy vertaalt CommandCode streaming events naar OpenAI-compatible chat-completion chunks/responses.

v0.0.10

• Plugin start de lokale proxy vanuit de OpenCode config hook.
• Gesyncte opencode.jsonc heeft geen absolute lokale file:// plugin path meer nodig.

v0.0.9

• CommandCode protocol headers bijgewerkt naar CLI-versie 0.26.3.
• Productie CLI-environment en OpenCommand project slug toegevoegd.

v0.0.8

• Non-blocking OpenCode startup: cached/static models direct, proxy/plan refresh op de achtergrond.