Instalação

Name: Archgate CLI
Author: Archgate

Instalação standalone (recomendado)

A forma mais rápida de instalar o Archgate — sem necessidade de Node.js ou gerenciador de pacotes:

# 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

Isso baixa um binário pré-compilado para sua plataforma e instala em ~/.archgate/bin/. O instalador detecta os perfis do seu shell e oferece adicionar o diretório ao seu PATH.

No Windows, o instalador PowerShell também detecta perfis de shell do Git Bash (.bashrc, .bash_profile, .profile) e oferece configurar o PATH neles.

Você pode personalizar a instalação com variáveis de ambiente:

Variável	Descrição	Padrão
`ARCHGATE_VERSION`	Instalar uma versão específica (ex: `v0.11.2`)	Última versão
`ARCHGATE_INSTALL_DIR`	Diretório de instalação personalizado	`~/.archgate/bin`

Você também pode baixar os binários diretamente das GitHub Releases.

Instalar via npm

Instale o Archgate globalmente usando seu gerenciador de pacotes Node.js preferido:

# npm
npm install -g archgate

# Bun
bun install -g archgate

# Yarn
yarn global add archgate

# pnpm
pnpm add -g archgate

Isso instala um wrapper leve que delega para um binário específico da plataforma. A CLI em si é um binário standalone compilado com Bun — o Node.js é necessário apenas para o wrapper do npm/yarn/pnpm.

Instalar como dependência de desenvolvimento

Você também pode adicionar o Archgate como dependência de desenvolvimento no seu projeto e executá-lo através do script runner do seu gerenciador de pacotes. Isso é útil para fixar uma versão específica por projeto ou executar verificações no CI sem uma instalação global.

# npm
npm install -D archgate

# Bun
bun add -d archgate

# Yarn
yarn add -D archgate

# pnpm
pnpm add -D archgate

Depois execute o Archgate pelo seu gerenciador de pacotes:

# npm / Yarn / pnpm
npx archgate check

# Bun
bun run archgate check

Ou adicione um script ao seu 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

Suporte a plataformas

O Archgate disponibiliza binários pré-compilados para as seguintes plataformas:

Plataforma	Arquitetura	Artefato
macOS	arm64	`archgate-darwin-arm64`
Linux	x86_64	`archgate-linux-x64`
Windows	x86_64	`archgate-win32-x64`

O binário correto é baixado automaticamente do GitHub Releases na primeira execução e armazenado em cache em ~/.archgate/bin/.

Verificar a instalação

archgate --version

Você deverá ver a versão instalada impressa no stdout.

Instalar via proto

Se você usa o proto (gerenciador de toolchain do moonrepo), pode instalar o Archgate diretamente como um plugin proto — sem necessidade de Node.js ou npm.

Adicione o plugin ao seu .prototools:

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

Depois instale e use como qualquer outra ferramenta proto:

proto install archgate
archgate check

O proto gerencia o binário para você, incluindo fixação de versão e instalação automática. Para fixar uma versão específica, adicione na raiz do .prototools:

archgate = "0.15.0"

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

Você também pode listar versões disponíveis e gerenciar instalações com comandos do proto:

proto list-remote archgate     # listar versões disponíveis
proto install archgate 0.15.0  # instalar uma versão específica
proto pin archgate 0.15.0      # fixar versão no .prototools

Próximos passos

Após a instalação, execute archgate init no seu projeto para configurar a governança. Veja o guia de Início Rápido para um passo a passo.