---
title: Instalação
description: Instale o Archgate CLI no macOS, Linux ou Windows via instalador, npm ou binário standalone. Comece a aplicar ADRs como regras de código executáveis em minutos.
---

## Instalação standalone (recomendado)

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

```bash
# 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](https://github.com/archgate/cli/releases).

## Instalar via npm

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

```bash
# 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.

```bash
# 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:

```bash
# npm / Yarn / pnpm
npx archgate check

# Bun
bun run archgate check
```

Ou adicione um script ao seu `package.json`:

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

```bash
# 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

```bash
archgate --version
```

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

## Instalar via proto

Se você usa o [proto](https://moonrepo.dev/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`:

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

Depois instale e use como qualquer outra ferramenta proto:

```bash
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`:

```toml
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:

```bash
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
```

:::note[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 a governança. Veja o guia de [Início Rápido](/getting-started/quick-start/) para um passo a passo.

:::tip[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](/guides/claude-code-plugin/) e [Cursor](/guides/cursor-integration/) adicionam um fluxo completo de governança sobre a CLI. [Cadastre-se para acesso beta](https://plugins.archgate.dev).
:::