Ga naar inhoud
opencode-memHome

Auto-capture AI-provider

Auto-capture draait een achtergrond-AI-verzoek om technisch werk samen te vatten en als geheugen op te slaan. Het heeft een van de onderstaande providerconfiguraties nodig.

Aanbevolen: Gebruik een provider die al in opencode is geauthenticeerd en structured output ondersteunt:

"opencodeProvider": "anthropic",
"opencodeModel": "claude-haiku-4-5-20251001",

De plugin stuurt structured-output-verzoeken naar de session-API van opencode in plaats van providerendpoints rechtstreeks aan te roepen, zodat opencode auth, tokenvernieuwing en providerrouting beheert. De providernaam moet overeenkomen met een entry uit opencode providers list, en het geselecteerde model moet structured JSON-output via opencode ondersteunen.

Optioneel kun je een model-reasoningvariant vastzetten met "opencodeVariant": "xhigh" (bijv. voor grok-4.7). Die wordt toegepast op de interne LLM-calls van de plugin (auto-capture-samenvattingen, profiel-leren, profielopschoning), ook wanneer opencodeModel "inherit" is, zodat achtergrondwerk een ander reasoningniveau kan gebruiken dan de interactieve sessie.

Trage reasoningmodellen (of zeer grote profielprompts) kunnen het standaard 90 s structured-output-budget overschrijden. Stel "opencodeTimeoutMs" (milliseconden) in om het te verlengen voor interne structured-output-calls (auto-capture-samenvattingen, profiel-leren) — bijv. "opencodeTimeoutMs": 180000 voor 3 minuten. Waarden worden geclampt tot 10000..600000; de standaard blijft 90000. Numerieke strings worden gecoeerd. Profielopschoning gebruikt een aparte, langere timeout.

Ondersteunde providers: elke provider uit opencode providers list (bijv. anthropic, openai, github-copilot, …).

Als opencodeProvider en opencodeModel zijn ingesteld, hebben ze voorrang op de handmatige memoryProvider-instellingen hieronder.

Volg het sessiermodel: stel "opencodeModel": "inherit" in om op call-tijd een concreet OpenCode-model te gebruiken in plaats van een vastgezette id. Voor auto-capture wordt elke prompt via de chat.params-hook vastgelegd en hergebruikt het capture-verzoek provider/model van die prompt. Voor profiel-leren en andere structured-output-paden (die niet aan één gebruikersbericht zijn gebonden) hergebruikt inherit eerst het laatste model dat de host via chat.params / de V2-context-hook meldde, en valt daarna terug op OpenCode’s model.json-recentelijst indien aanwezig (met voorkeur voor de geconfigureerde opencodeProvider). OpenCode v2 schrijft model.json niet meer; daar is het in-process-sessiemodel de primaire fallback. Het letterlijke model-id inherit versturen is nooit geldig en veroorzaakte eerder ProviderModelNotFoundError: Model not found: <provider>/inherit op die paden. opencodeProvider blijft vereist als normale configgate.

Fallback: Handmatige API-configuratie (als je geen opencodeProvider gebruikt):

"memoryProvider": "openai-chat",
"memoryModel": "gpt-4o-mini",
"memoryApiUrl": "https://api.openai.com/v1",
"memoryApiKey": "sk-...",

API-sleutelformaten:

"memoryApiKey": "sk-..."
"memoryApiKey": "file://~/.config/opencode/api-key.txt"
"memoryApiKey": "env://OPENAI_API_KEY"

Handmatige memoryProvider-modi:

  • openai-chat: OpenAI Chat Completions-compatibele API met tool/function calling. Dit kan werken met compatibele proxies zoals LiteLLM alleen wanneer het geselecteerde upstream-model en de proxy tool calls behouden.
  • openai-responses: OpenAI Responses API met function-call-output.
  • anthropic: Anthropic Messages API met tool use.
  • minimax: MiniMax Anthropic Messages-compatibel endpoint. Stel memoryApiUrl in op het globale endpoint (https://api.minimax.io) of het China-endpoint (https://api.minimax.cn); het pad /anthropic/v1/messages en de header x-api-key worden automatisch toegepast. Gebruik MiniMax-M3.1-Flash (aanbevolen) of MiniMax-M3, beide met een 1.000.000-token context. Flash denkt altijd; stel optioneel memoryExtraParams in op { "output_config": { "effort": "max" } } met low, medium, high, xhigh of max (standaard). Flash weigert uitgeschakeld thinking en effort none, en ondersteunt geen service_tier. M3-thinking staat op dit endpoint standaard uit; zet het aan met { "thinking": { "type": "adaptive" } }. Model-ID’s blijven expliciet geconfigureerd; bestaande custom of legacy-ID’s worden ongewijzigd doorgestuurd. Zie de MiniMax-compatibiliteitsreferentie.
  • orcarouter: OpenAI-compatibele modelgateway met namespaced model-ID’s. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://api.orcarouter.ai/v1 en orcarouter/auto (een routingalias die per verzoek een capabel model kiest). Als je memoryModel instelt, gebruik een namespaced ID zoals openai/gpt-5.5 of deepseek/deepseek-v4-flash; OrcaRouter weigert bare modelnamen. Voorbeeld: 
    "memoryProvider": "orcarouter",
    "memoryApiKey": "<OrcaRouter API key>",
    OrcaRouter draait ook gateway-level, zero-trust security voor AI-agents op hetzelfde endpoint — screening van elke prompt/response en governance van elke tool call op default-deny-basis, zonder wijzigingen in applicatiecode.
  • atlas-cloud: OpenAI-compatibel Chat Completions-preset voor Atlas Cloud. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://api.atlascloud.ai/v1 en deepseek-ai/deepseek-v4-pro. Als memoryApiKey wordt weggelaten, wordt ATLASCLOUD_API_KEY uit de omgeving gebruikt. Voorbeeld: 
    "memoryProvider": "atlas-cloud",
    "memoryApiKey": "env://ATLASCLOUD_API_KEY",
    Wanneer deze provider is geselecteerd, worden auto-capture- / profielprompts, modelantwoorden en relevante conversatiecontext verzonden naar https://api.atlascloud.ai.
  • cheaper-inference: OpenAI-compatibel Chat Completions-preset voor Cheaper Inference. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://api.cheaperinference.com/v1 en gpt-5.4-mini. Als memoryApiKey wordt weggelaten, wordt CHEAPER_INFERENCE_API_KEY uit de omgeving gebruikt. Voorbeeld: 
    "memoryProvider": "cheaper-inference",
    "memoryApiKey": "env://CHEAPER_INFERENCE_API_KEY",
    Wanneer deze provider is geselecteerd, worden auto-capture- / profielprompts, modelantwoorden en relevante conversatiecontext verzonden naar https://api.cheaperinference.com.
  • api-route: OpenAI-compatibel Chat Completions-preset voor API Route. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://global.api-route.com/v1 en gpt-6.1-sol. Als memoryApiKey wordt weggelaten, wordt API_ROUTE_API_KEY uit de omgeving gebruikt. Voorbeeld: 
    "memoryProvider": "api-route",
    "memoryApiKey": "env://API_ROUTE_API_KEY",
    Wanneer deze provider is geselecteerd, worden auto-capture- / profielprompts, modelantwoorden en relevante conversatiecontext verzonden naar https://global.api-route.com.
  • runcrate: OpenAI-compatibel Chat Completions-preset voor Runcrate. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://api.runcrate.ai/v1 en deepseek-ai/DeepSeek-V4.1-Flash. Als memoryApiKey wordt weggelaten, wordt RUNCRATE_API_KEY uit de omgeving gebruikt. Voorbeeld: 
    "memoryProvider": "runcrate",
    "memoryApiKey": "env://RUNCRATE_API_KEY",
    Wanneer deze provider is geselecteerd, worden auto-capture- / profielprompts, modelantwoorden en relevante conversatiecontext verzonden naar https://api.runcrate.ai.
  • cloudgpu: OpenAI-compatibel Chat Completions-preset voor CloudGPU. memoryApiUrl en memoryModel zijn optioneel — ze defaulten naar https://cloudgpu.app/v1 en deepseek-v4.1-flash. Als memoryApiKey wordt weggelaten, wordt CLOUDGPU_API_KEY uit de omgeving gebruikt (maak een key aan via https://cloudgpu.app/api/console; API-docs: https://cloudgpu.app/api/docs). Voorbeeld: 
    "memoryProvider": "cloudgpu",
    "memoryApiKey": "env://CLOUDGPU_API_KEY",
    Wanneer deze provider is geselecteerd, worden auto-capture- / profielprompts, modelantwoorden en relevante conversatiecontext verzonden naar https://cloudgpu.app.

Probleemoplossing:

  • Auto-capture-fouten blokkeren handmatig memory-toolgebruik niet.
  • Als auto-capture meldt dat een provider niet verbonden is, bevestig de providernaam met opencode providers list en configureer die provider eerst in opencode.
  • Als een proxy of custom provider platte tekst teruggeeft in plaats van structured/tool-output, kies een ander model/provider of gebruik een van de handmatige providermodi hierboven.
  • Voor modellen die temperature weigeren, voeg "memoryTemperature": false toe bij handmatige API-configuratie.
  • Voor modellen die geforceerde tool calls weigeren (tool_choice: "required", bijv. sommige thinking-modi), voeg "forceToolChoice": false toe bij openai-chat / orcarouter / atlas-cloud / cheaper-inference / api-route / runcrate / cloudgpu.
  • Voor opencodeProvider / opencodeModel (bijv. DeepSeek V4 thinking) stuurt OpenCode nog steeds geforceerde tool_choice voor structured output. opencode-mem schakelt thinking uit op de interne opencode-mem-structured-agent (en past dat opnieuw toe in chat.params na variant-merge) zodat auto-capture en profiel-leren kunnen voltooien. Je interactieve chatagent blijft ongewijzigd. Als capture nog steeds faalt met een thinking/tool_choice-fout, kies een non-thinking model voor opencodeModel of configureer een complete handmatige fallback (memoryModel + memoryApiUrl).
  • opencode-claude-auth / Claude Code: auto-capture gebruikt OpenCode met je geauthenticeerde anthropic-provider. Geforceerde format: json_schema loopt vaak vast met Claude-auth, dus opencode-mem gebruikt een auth-behoudend text-JSON-pad voor opencodeProvider: "anthropic" (geen geforceerde StructuredOutput-tools; antwoord wordt met Zod geparsed). Een step-watchdog breekt runaway interne sessies nog steeds af na 2 stappen. Als capture nog steeds faalt, configureer een complete handmatige Anthropic API-key-fallback (memoryProvider: "anthropic" + memoryModel + memoryApiUrl + memoryApiKey) — Claude Pro/Max OAuth kan niet buiten OpenCode worden hergebruikt.
  • Niet-ondersteunde platforms: Intel Mac (darwin/x64) wordt niet ondersteund — @tursodatabase/database en vaste onnxruntime-node-releases (vastgezet 1.31.1) leveren geen x64 native binding. Gebruik Apple Silicon, Linux of Windows, of een remote embedding-endpoint via embeddingApiUrl + embeddingApiKey. MLX wordt niet ondersteund.