Instalação

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

Instalar via pip (Python)

Instale o Archgate globalmente usando pip ou pipx:

# pip
pip install archgate

# pipx (recomendado para ferramentas CLI)
pipx install archgate

Isso instala um wrapper leve em Python que delega para um binário específico da plataforma. Requer Python 3.8+.

Instalar via dotnet

Instale o Archgate como uma ferramenta global .NET:

dotnet tool install -g archgate

Requer .NET 8.0+ SDK. A ferramenta baixa o binário da plataforma na primeira execução.

Instalar via Go

Instale o Archgate usando go install:

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

Requer Go 1.21+. O wrapper compilado em Go baixa o binário da plataforma na primeira execução.

Instalar via RubyGems

Instale o Archgate como uma gem Ruby:

gem install archgate

Requer Ruby 2.7+. A gem baixa o binário da plataforma na primeira execução.

Instalar via Maven / jbang (Java)

Instale o Archgate usando jbang:

jbang app install [email protected]

Ou baixe o JAR executável do Maven Central (dev.archgate:archgate-cli) e execute diretamente:

java -jar archgate-cli-0.39.0.jar check

Requer Java 11+. O shim baixa o binário da plataforma na primeira execução.

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

Usando npm globals com proto?

Se você preferir npm install -g archgate ao invés do plugin proto, precisa configurar o proto para expor binários npm globais. Adicione shared-globals-dir = true em [tools.npm] no ~/.proto/config.toml, e depois adicione $HOME/.proto/tools/node/globals/bin ao PATH do seu shell.

Próximos passos

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

Plugins para editores (beta)

Quer que seu agente de IA leia ADRs antes de programar e valide depois? Os plugins para editores do Claude Code e Cursor adicionam um fluxo completo de guardrails sobre a CLI. Execute archgate login para se cadastrar e começar.