CLI-instellingen (config.json)

Elk veld van config.json: hoe de openspec-CLI zich op jouw machine gedraagt.

Locatie

De CLI bewaart zijn instellingen op machineniveau in ~/.config/openspec/config.json op macOS en Linux, en in %APPDATA%\openspec\config.json op Windows. $XDG_CONFIG_HOME heeft voorrang op elk platform wanneer dit is ingesteld. Het openspec config-commando leest en bewerkt dit bestand.

Velden

Sleutel	Type	Vereist	Effect
profile	string: core of custom	Nee	Kiest de workflowset die openspec init installeert
delivery	string: both, skills of commands	Nee	Bepaalt of init vaardigheden, slash-commando's of beide installeert
workflows	lijst van strings	Nee	De workflowlijst die een custom-profiel installeert
featureFlags	kaart: vlag → boolean	Nee	Booleaanse functieschakelaars
defaultStore	string	Nee	Fallback-opslag op machineniveau voor rootresolutie
openers	kaart: tool-id → instellingen	Nee	De tools waarin worksets openen, en hoe elk wordt gestart
telemetry	kaart	Nee	Telemetrie-opt-out, anonieme id en status van geziene melding

profile

Welke workflowset openspec init installeert. Standaard core: propose, explore, apply, update, sync en archive. Het instellen van custom installeert precies de workflows-lijst in plaats daarvan.

delivery

Bepaalt of init workflows installeert als vaardigheden, als slash-commando's of als beide. Standaard both.

workflows

De workflows die een custom-profiel installeert; genegeerd wanneer het profiel core is. Geldige id's: propose, explore, new, continue, apply, update, ff, sync, archive, bulk-archive, verify, onboard.

featureFlags

Booleaanse schakelaars, gesleuteld op vlaggennaam, ingesteld met openspec config set featureFlags.<vlag> true. Geen enkele vlag wordt momenteel door de CLI gelezen.

defaultStore

De fallback-opslag-id op machineniveau voor rootresolutie, alleen geraadpleegd wanneer geen --store-vlag, lokale openspec/ of project-store:-pointer de resolutie bepaalt. De volledige ladder staat in Rootresolutie.

openers

De tools waarin een workset kan openen, gesleuteld op tool-id. Bewerk openers in het globale config.json met openspec config edit in je terminal.

Veld	Contract
style	workspace-file of attach-dirs. Vereist voor een nieuwe tool; optioneel voor een ingebouwde.
label	Niet-lege string, getoond in de toolkiezer. Standaard de id voor een nieuwe tool.
command	Niet-lege uitvoerbare naam of pad. Standaard de id voor een nieuwe tool. Zet argumenten in args, niet in deze string.
args	Array van strings, doorgegeven vóór het workspace-bestand of de attach-vlaggen. Standaard [] voor een nieuwe tool.
attach_flag	Niet-lege string, gekoppeld aan elk lidpad voor attach-dirs. Standaard --add-dir voor een nieuwe tool. Genegeerd voor workspace-file.

Ingebouwde overschrijvingen: code, cursor, claude en codex behouden alle velden die je weglaat. Het instellen van args vervangt de volledige argumentenlijst; [] wist deze.

Startstijlen: workspace-file geeft het gegenereerde .code-workspace-pad door aan de uitvoerbare. attach-dirs geeft één vlag/pad-paar door per lid, inclusief het primaire lid.

Beschikbaarheid: attach-dirs-openers, waaronder Claude Code en Codex, zijn standaard uitgeschakeld. Je kunt ze niet selecteren of opslaan met --tool, en OpenSpec weigert een workset te openen die er al een benoemt. Configuratie-overschrijvingen schakelen de attach-dirs-startstijl niet in.

Validatie: onbekende velden, ongeldige typen en een nieuwe tool zonder style falen wanneer een workset-commando de openers-tabel leest.

Dit voorbeeld voegt VS Code Insiders toe en geeft --new-window door telkens wanneer de ingebouwde VS Code-opener start:

{
  "openers": {
    "code-insiders": {
      "style": "workspace-file",
      "label": "VS Code Insiders"
    },
    "code": {
      "args": ["--new-window"]
    }
  }
}

De bijbehorende code-insiders- of code-uitvoerbare moet geïnstalleerd zijn en beschikbaar op PATH.

telemetry

De CLI slaat je anonieme id op en of de eerste-runmelding is getoond. Stel telemetry.enabled in op false om telemetrie uit te schakelen. Je kunt je ook afmelden met OPENSPEC_TELEMETRY=0 of DO_NOT_TRACK=1 in je omgeving.

Voorbeeld

Een ingevuld config.json:

{
  "profile": "core",
  "delivery": "both",
  "featureFlags": {},
  "telemetry": {
    "anonymousId": "5f8a2c1e-4b6d-4f9a-9c3d-7e1b2a8d4c6f",
    "noticeSeen": true
  }
}