Instalar ank

Dos pasos independientes: el binario, que es la herramienta, y las skills, que enseñan a tu agente a usarla. Elige la línea de tu máquina y luego ejecuta la segunda.

1El binario

  • npm

    Cualquier máquina con node. La vía que atraviesa un firewall que bloquea un ejecutable suelto pero deja pasar un registro.

    npm install -g @haksolot/ank
    
  • curl | sh

    Linux y macOS. Descarga el archivo y su .sha256, y se niega a descomprimir si no coinciden.

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

    Windows, en Windows PowerShell 5.1 o PowerShell 7. La misma comprobación, y puede reemplazar un ank.exe que sigue en ejecución.

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

2Las skills

Un comando para todos los agentes. Detecta los que usas (Claude Code, Codex, Cursor, OpenCode y una treintena más) y enlaza cada uno a una única copia de las seis skills.

npx skills add haksolot/ank

Qué necesitas

Dos cosas, y una tercera solo si compilas desde el código fuente.

git 2.34 o posterior
No es una comodidad: los claims viven en refs de git, y ank comprueba la versión al arrancar.
sh
Los verificadores se ejecutan con sh -c en los tres sistemas. En Windows viene con Git for Windows, así que al exigir git ya lo tienes.
Rust 1.95 o posterior
Solo para compilar desde el código fuente, junto con un compilador de C.

Comprueba que responde

Sea cual sea la vía que elegiste, pregúntale al binario qué es.

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

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

Tres componentes, cada uno la respuesta a una pregunta que algún día te harás:

La versión0.8.0
Lo que instalaste. Es 0.x a propósito: el bucle y los códigos de salida están especificados, el formato de almacenamiento todavía no.
El commit8310e75
Desde dónde se compiló. Importa la primera vez que sospechas que tu binario es más antiguo que el comportamiento que estás leyendo.
La revisión de la skillskill 0d916cc3d9a5
La skill con la que se compiló. Un agente que cargó la skill puede comparar esa cadena con la que imprime su herramienta y ver por sí mismo que sus instrucciones son anteriores a su binario.

Actualizar

ank update --check lee la última versión publicada y no instala nada. ank update la instala por la misma vía que colocó el binario que usas, y muestra antes ese comando. Nunca toca las skills: cuando cambia su revisión, lo indica y te deja a ti la reinstalación. Ningún otro verbo accede a la red para esto.

Plataformas

Linux, macOS y Windows. Exactamente qué vía cubre qué máquina:

Vías de instalación por plataforma
Plataformanpmcurl | shPowerShell
Linux x64
Linux arm64
macOS, Apple silicon
macOS, Intel
Windows x64

Donde el paquete npm no trae binario, el wrapper sale con código 9 e indica cargo install. Donde ninguna release lo publica, curl | sh se niega nombrando la plataforma y lista lo que sí existe. Ninguno falla en silencio.

Cuando ninguna de las tres encaja

La página de releases tiene los archivos que descargan los dos instaladores, uno por target con su .sha256 al lado: descomprimir uno a mano es justo lo que ellos hacen por ti. Y el árbol compila:

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

Página de releases

Ningún gestor de paquetes distribuye ank. Homebrew, Scoop, apt, winget y el AUR tuvieron cada uno un canal o un intento, y todos se retiraron. Tres vías, servidas desde el repositorio y derivadas de una release publicada.

Las skills

Seis archivos markdown planos. El primero es el que un agente carga por defecto y se basta solo; los otros cinco llevan una actividad cada uno y se cargan cuando el trabajo lo pide.

ank
El contrato: por qué ank tiene esta forma, los comandos según el momento en que los usas, las reglas que no se negocian.
ank-plan
Convertir un objetivo en ADRs, specs y tareas, a base de preguntas.
ank-drift
Auditar las decisiones frente al código.
ank-loop
Trabajar el backlog de forma autónoma.
ank-tdd
Llevar una implementación test-first.
ank-diagnose
Rastrear un defecto hasta su causa.

Otras formas de instalarlas

Todas las vías apuntan a los mismos seis archivos en git. Ninguna guarda una copia que alguien sincronice a mano.

  • Claude Code

    Como plugin: seis skills y nada más. Ni agente, ni hook, ni servidor, así que nada se ejecuta a menos que llames a ank.

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

    El paquete npm lleva la skill junto al binario. pi carga recursos y no pone ank en tu PATH: instala también el binario.

    pi install npm:@haksolot/ank
    
  • A mano

    Copia skill/SKILL.md donde tu harness lo cargue. Cada skill es un solo archivo sin nada generado: no pierdes nada.

La guía de instalación completa

Instalar ank

Dos comandos. Linux, macOS y Windows, con git 2.34 o posterior.

npm install -g @haksolot/ank
npx skills add haksolot/ank