Installasjon

Frittstående installasjon (anbefalt)

Den raskeste måten å installere Archgate på. Ingen Node.js eller pakkebehandler nødvendig:

# macOS / Linux
curl -fsSL https://cli.archgate.dev/install-unix | sh

# Windows (PowerShell)
irm https://cli.archgate.dev/install-windows | iex

# Windows (Git Bash / MSYS2)
curl -fsSL https://cli.archgate.dev/install-unix | sh

Dette laster ned en forhåndskompilert binærfil for din plattform og installerer den til ~/.archgate/bin/. Installatøren oppdager shell-profilene dine og tilbyr å legge mappen til PATH.

På Windows oppdager PowerShell-installatøren også Git Bash shell-profiler (.bashrc, .bash_profile, .profile) og tilbyr å konfigurere PATH der også.

Du kan tilpasse installasjonen med miljøvariabler:

Variabel	Beskrivelse	Standard
ARCHGATE_VERSION	Installer en bestemt versjon (f.eks. v0.11.2)	Siste versjon
ARCHGATE_INSTALL_DIR	Egendefinert installasjonsmappe	~/.archgate/bin

Du kan også laste ned binærfiler direkte fra GitHub Releases.

Installer via winget (Windows)

Venter på gjennomgang i winget-pkgs

Archgate.Archgate står i kø for å bli tatt inn i winget-fellesskapets repositorium. Inntil pakken er publisert der, returnerer denne kommandoen “No package found” — bruk den frittstående installatøren over i mellomtiden.

På Windows kan du installere Archgate med Windows Package Manager:

winget install Archgate.Archgate

Dette installerer en liten, portabel wrapper og legger archgate i PATH. Ved første kjøring lastes plattformbinærfilen ned, sjekksummen verifiseres, og filen mellomlagres i ~/.archgate/bin/ — samme cache som alle andre installasjonsmetoder bruker, så du laster ikke ned noe på nytt når du bytter mellom dem.

Oppgrader med winget upgrade Archgate.Archgate.

Installer via npm

Installer Archgate globalt med din foretrukne Node.js-pakkebehandler:

# npm
npm install -g archgate

# Bun
bun install -g archgate

# Yarn
yarn global add archgate

# pnpm
pnpm add -g archgate

Dette installerer en lettvekts-wrapper som delegerer til en plattformspesifikk binærfil. CLI-en er en frittstående binærfil kompilert med Bun — Node.js trengs bare for npm/yarn/pnpm-wrapperen.

Installer som utviklingsavhengighet

Du kan også legge til Archgate som en utviklingsavhengighet i prosjektet ditt og kjøre den gjennom pakkebehandlerens script runner. Dette er nyttig for å låse en bestemt versjon per prosjekt eller kjøre sjekker i CI uten global installasjon.

# npm
npm install -D archgate

# Bun
bun add -d archgate

# Yarn
yarn add -D archgate

# pnpm
pnpm add -D archgate

Deretter kjører du Archgate via pakkebehandleren din:

# npm / Yarn / pnpm
npx archgate check

# Bun
bun run archgate check

Eller legg til et script i package.json:

{ "scripts": { "check:adrs": "archgate check" } }

# Works with any package manager
npm run check:adrs
bun run check:adrs
yarn check:adrs
pnpm check:adrs

Installer via pip (Python)

Installer Archgate globalt med pip eller pipx:

# pip
pip install archgate

# pipx (anbefalt for CLI-verktøy)
pipx install archgate

Dette installerer en lettvekts Python-wrapper som delegerer til en plattformspesifikk binærfil. Python 3.8+ kreves.

Installer via dotnet

Installer Archgate som et globalt .NET-verktøy:

dotnet tool install -g archgate

Krever .NET 8.0+ SDK. Verktøyet laster ned plattformbinæren ved første kjøring.

Installer via Go

Installer Archgate med go install:

go install github.com/archgate/cli/shims/go/cmd/archgate@latest

Krever Go 1.21+. Den kompilerte Go-wrapperen laster ned plattformbinæren ved første kjøring.

Installer via RubyGems

Installer Archgate som en Ruby-gem:

gem install archgate

Krever Ruby 2.7+. Gem-en laster ned plattformbinæren ved første kjøring.

Installer via Maven / jbang (Java)

Installer Archgate med jbang:

jbang app install [email protected]

Eller last ned den nyeste kjørbare JAR-en fra Maven Central (dev.archgate:archgate-cli) og kjør den direkte:

java -jar archgate-cli-<version>.jar check

Krever Java 11+. Shimen laster ned plattformbinæren ved første kjøring.

Plattformstøtte

Archgate leverer forhåndskompilerte binærfiler for følgende plattformer:

Plattform	Arkitektur	Artefakt
macOS	arm64	archgate-darwin-arm64
Linux	x86_64	archgate-linux-x64
Windows	x86_64	archgate-win32-x64

Riktig binærfil lastes ned automatisk fra GitHub Releases ved første kjøring og hurtiglagres i ~/.archgate/bin/.

Verifiser installasjonen

archgate --version

Du bør se den installerte versjonen skrevet ut til stdout.

Installer via proto

Hvis du bruker proto (moonrepos verktøykjedebehandler), kan du installere Archgate direkte som en proto-plugin — ingen Node.js eller npm nødvendig.

Legg til pluginen i .prototools:

[plugins.tools]
archgate = "github://archgate/proto-plugin"

Deretter installerer og bruker du den som et hvilket som helst annet proto-verktøy:

proto install archgate
archgate check

Proto administrerer binærfilen for deg, inkludert versjonslåsing og automatisk installasjon. For å låse en bestemt versjon, legg den til i roten av .prototools:

archgate = "0.15.0"

[plugins.tools]
archgate = "github://archgate/proto-plugin"

Du kan også liste tilgjengelige versjoner og administrere installasjoner med proto-kommandoer:

proto list-remote archgate   # liste tilgjengelige versjoner
proto install archgate 0.15.0  # installere en bestemt versjon
proto pin archgate 0.15.0      # låse versjon i .prototools

Bruker du npm globals med proto?

Hvis du foretrekker npm install -g archgate i stedet for proto-pluginen, må du konfigurere proto til å eksponere globale npm-binærfiler. Legg til shared-globals-dir = true under [tools.npm] i ~/.proto/config.toml, og legg deretter til $HOME/.proto/tools/node/globals/bin i shell-PATHen din.

Neste steg

Etter installasjonen, kjør archgate init i prosjektet ditt for å sette opp linting og guardrails. Se guiden Hurtigstart for en gjennomgang.

Editorplugins (beta)

Vil du at AI-agenten din skal lese ADR-er før den koder og validere etterpå? Editorpluginene for Claude Code og Cursor legger til en komplett guardrails-arbeidsflyt på toppen av CLI-en. Kjør archgate login for å logge inn og komme i gang.