Instalação

A CLI do Archgate é o motor de execução por trás de toda a plataforma — ela faz o scaffold da governança, roda verificações, importa ADR packs e instala plugins de editor. Instale-a primeiro; todo o resto é construído sobre ela.

Esta página cobre os caminhos mais rápidos para uma CLI funcionando. Para a matriz completa de instalação (pip, dotnet, Go, RubyGems, jbang, instalações como dependência de desenvolvimento, fixação de versão e artefatos por plataforma), consulte a referência autoritativa de Instalação em cli.archgate.dev.

Instalar com o instalador de uma linha (recomendado)

A forma mais rápida de instalar o Archgate — sem necessidade de Node.js ou gerenciador de pacotes. Ele baixa um binário pré-compilado para a sua plataforma, instala-o em ~/.archgate/bin/ e oferece adicionar esse diretório ao seu PATH.

macOS / Linux

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

Windows (PowerShell)

irm https://cli.archgate.dev/install-windows | iex

Windows (Git Bash)

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

Instalar com o proto

Se você usa o proto, o gerenciador de toolchain da moonrepo, pode instalar o Archgate como um plugin do proto — sem necessidade de Node.js ou npm. Esse é um encaixe limpo se a sua equipe já fixa versões de ferramentas com o proto.

Adicione o plugin ao seu .prototools:

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

Em seguida, instale-o e use-o como qualquer outra ferramenta do proto:

proto install archgate
archgate check

O proto gerencia o binário para você, incluindo a fixação de versão e a instalação automática.

Usando globais do npm com o proto?

Se você prefere npm install -g archgate em vez do plugin do proto, configure o proto para expor binários globais do npm. Consulte as notas sobre o proto na referência de instalação da CLI para as configurações exatas de ~/.proto/config.toml.

Instalar com npm

Se você já gerencia ferramentas por meio de um gerenciador de pacotes Node.js, instale o Archgate globalmente:

npm install -g archgate

Isso instala um wrapper leve que baixa e delega para um binário específico da plataforma. A CLI em si é um binário standalone compilado com Bun — o Node.js só é necessário para o wrapper. Bun, Yarn e pnpm também funcionam; consulte a referência de instalação da CLI para esses casos e para instalar o Archgate como dependência de desenvolvimento de um projeto.

Verificar a instalação

archgate --version

Você deve ver a versão instalada impressa na stdout. Se o comando não for encontrado, o diretório de instalação ainda não está no seu PATH — execute o instalador novamente (ele oferece configurar o PATH) ou abra um novo shell.

Próximos passos

1. Instale a CLI usando uma das opções acima.

2. Rode archgate init no seu projeto para fazer o scaffold da governança — detalhado no Início Rápido.

3. Adicione um plugin de editor para que o seu agente de IA leia os ADRs antes de programar e valide depois.

Início Rápido Rode o ciclo completo: init, check, adicionar um plugin e rodar o reviewer.

Referência completa de instalação Todos os métodos de instalação, fixação de versão e artefatos por plataforma.