archgate init

Sett opp Archgate-linting og regelhåndhevelse i det gjeldende prosjektet.

archgate init [options]

Oppretter .archgate/-katalogen med en eksempel-ADR og en linter-regelkatalog. Kan valgfritt konfigurere editor-integrasjon for AI-agentarbeidsflyter og installere Archgate editor-pluginen.

Valg

Valg	Standard	Beskrivelse
--editor <editor>	claude	Editor-integrasjon å konfigurere (claude, cursor, vscode, copilot, opencode)
--install-plugin	auto	Installer Archgate editor-pluginen (krever tidligere archgate login)

Når --install-plugin sendes med, installerer CLI-en Archgate-pluginen for den valgte editoren. Hvis flagget utelates, autodetekterer CLI-en: den installerer pluginen når gyldig legitimasjon finnes (fra en tidligere archgate login) og hopper over ellers.

Installasjonsoppførsel for plugins

Claude Code: Hvis claude-CLI-en er på din PATH, installeres pluginen automatisk via claude plugin marketplace add og claude plugin install. Hvis claude-CLI-en ikke finnes, skriver kommandoen ut de manuelle installasjonskommandoene i stedet.

Cursor: Laster ned en autentisert tarball med skills, agenter og hooks i ~/.cursor/. Skriver også .cursor/hooks.json til prosjektet for kompatibilitet med skyagenter. Ingen CLI-deteksjon nødvendig.

opencode: Krever at opencode blir oppdaget — enten opencode-CLI-en på din PATH, eller at opencodes konfigurasjonskatalog på brukernivå finnes (skrivebordsappen leveres uten CLI-binær). Hvis ingen av delene blir funnet, hoppes installasjonen over og en melding ber deg installere opencode først. Når den er oppdaget, laster CLI-en ned en autentisert tarball fra Archgate plugins-tjenesten og pakker ut katalogene agents/ og skills/ i opencodes konfigurasjonsrot på brukernivå ($XDG_CONFIG_HOME/opencode/, faller tilbake til $HOME/.config/opencode/ på alle plattformer inkludert Windows; opencode bruker XDG-stier via xdg-basedir og leser ikke %APPDATA%), og setter standardagenten i opencode.json når ingen er konfigurert. Ingen filer skrives til prosjekttreet. Se opencode-integrasjonsguiden for detaljer.

Utdata

Initialized Archgate governance in /path/to/project
  adrs/          - architecture decision records
  lint/          - linter-specific rules
  .claude/       - Claude Code settings configured

Archgate plugin installed for Claude Code.

Når --editor cursor brukes, viser utdataene .cursor/ for filer på prosjektnivå og noterer at brukerscope-komponenter ble installert til ~/.cursor/.

Deteksjon av hovedgren

Når kommandoen kjøres i et git-repositorium, autodetekterer archgate init hovedgrenen og lagrer den i .archgate/config.json som baseBranch-feltet. Dette lar archgate check hoppe over grendeteksjon ved hver kjøring, noe som sparer 1-4 git-subprosessanrop.

Deteksjonen prøver origin/HEAD, origin/main, origin/master, lokal main og lokal master (første treff vinner). Hvis ingen finnes (f.eks. ikke et git-repo), skrives ingen baseBranch.

Å kjøre archgate init på nytt overskriver ikke en manuelt konfigurert baseBranch. Se Konfigurasjon — baseBranch for detaljer.

Generert struktur

.archgate/
  adrs/
    GEN-001-example.md           # Example ADR (rules: false — no companion rules file)
  lint/
    README.md                    # Linter rules guide