pt

Instalar o ank

Dois passos separados: o binário, que é a ferramenta, e as skills, que ensinam o seu agente a usá-la. Escolha a linha da sua máquina e depois rode a segunda.

1O binário

  • npm

    Qualquer máquina com node. O caminho que passa por um firewall que bloqueia um executável solto mas libera um registry.

    npm install -g @haksolot/ank

  • curl | sh

    Linux e macOS. Baixa o arquivo e o .sha256 dele, e se recusa a descompactar se os dois não batem.

    curl -fsSL https://raw.githubusercontent.com/haksolot/ank/main/install.sh | sh

  • PowerShell

    Windows, no Windows PowerShell 5.1 ou no PowerShell 7. A mesma verificação, e consegue substituir um ank.exe que ainda está rodando.

    irm https://raw.githubusercontent.com/haksolot/ank/main/install.ps1 | iex

2As skills

Um comando para todos os agentes. Ele detecta os que você usa (Claude Code, Codex, Cursor, OpenCode e uns trinta outros) e liga cada um a uma única cópia das seis skills.

npx skills add haksolot/ank

O que você precisa

Duas coisas, e uma terceira só se você compilar a partir do código-fonte.

git 2.34 ou mais recente
Não é conveniência: os claims ficam em refs do git, e o ank confere a versão ao iniciar.
sh
Os verificadores rodam com sh -c nos três sistemas. No Windows ele vem com o Git for Windows, então exigir git já resolve.
Rust 1.95 ou mais recente
Só para compilar a partir do código-fonte, junto com um compilador C.

Confira se responde

Qualquer que tenha sido o caminho, pergunte ao binário o que ele é.

~
ank --version
ank 0.8.0 (8310e75, skill 0d916cc3d9a5)

ank update --check
running  0.8.0
latest   0.8.0
up to date

Três componentes, cada um a resposta a uma pergunta que você vai fazer um dia:

A versão0.8.0
O que você instalou. É 0.x de propósito: o loop e os códigos de saída estão especificados, o formato de armazenamento ainda não.
O commit8310e75
De onde ele foi compilado. Importa na primeira vez que você suspeitar que o seu binário é mais antigo que o comportamento sobre o qual está lendo.
A revisão da skillskill 0d916cc3d9a5
A skill com que ele foi compilado. Um agente que carregou a skill pode comparar essa string com a que a ferramenta imprime e ver sozinho que as instruções dele são mais antigas que o binário.

Atualizar

ank update --check lê a versão mais recente e não instala nada. ank update instala pela mesma rota que colocou o binário que você usa, e mostra esse comando antes. Ele nunca toca nas skills: quando a revisão delas muda, ele avisa e deixa a reinstalação com você. Nenhum outro verbo acessa a rede para isso.

Plataformas

Linux, macOS e Windows. Exatamente qual caminho cobre qual máquina:

Plataformanpmcurl | shPowerShell
Linux x64
Linux arm64
macOS, Apple silicon
macOS, Intel
Windows x64

Onde o pacote npm não traz binário, o wrapper sai com código 9 e indica cargo install. Onde nenhuma release publica um, curl | sh se recusa citando a plataforma e lista o que existe. Nenhum dos dois falha em silêncio.

Quando nenhum dos três serve

A página de releases tem os arquivos que os dois instaladores baixam, um por target com o .sha256 ao lado: descompactar um na mão é exatamente o que eles fazem por você. E a árvore compila:

cargo install --git https://github.com/haksolot/ank ank-cli

Página de releases

Nenhum gerenciador de pacotes distribui o ank. Homebrew, Scoop, apt, winget e o AUR tiveram cada um um canal ou uma tentativa, e todos foram retirados. Três caminhos, servidos a partir do repositório e derivados de uma release publicada.

As skills

Seis arquivos markdown simples. O primeiro é o que um agente carrega por padrão, e ele se basta; os outros cinco trazem uma atividade cada e são carregados quando o trabalho pede.

ank
O contrato: por que o ank tem essa forma, os comandos pelo momento em que você os usa, as regras que não se negociam.
ank-plan
Transformar um objetivo em ADRs, specs e tarefas, por entrevista.
ank-drift
Auditar as decisões contra o código.
ank-loop
Tocar o backlog de forma autônoma.
ank-tdd
Conduzir uma implementação test-first.
ank-diagnose
Rastrear um defeito até a causa.

Outros caminhos

Todo caminho aponta para os mesmos seis arquivos no git. Nenhum guarda uma cópia que alguém sincroniza na mão.

  • Claude Code

    Como plugin: seis skills e nada mais. Sem agente, sem hook, sem servidor, então nada roda a menos que você chame ank.

    /plugin marketplace add haksolot/ank
/plugin install ank@ank

  • pi

    O pacote npm traz a skill junto com o binário. O pi carrega recursos e não coloca ank no seu PATH: instale o binário também.

    pi install npm:@haksolot/ank

  • Na mão

    Copie skill/SKILL.md para onde o seu harness carrega. Cada skill é um arquivo só, sem nada gerado: você não perde nada.

O guia de instalação completo

Instalar o ank

Dois comandos. Linux, macOS e Windows, com git 2.34 ou mais recente.

npm install -g @haksolot/ank
npx skills add haksolot/ank
Ler o guia rápido