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
npmTu sistema
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/ankcurl | shTu sistema
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 | shPowerShellTu sistema
Windows, en Windows PowerShell 5.1 o PowerShell 7. La misma comprobación, y puede reemplazar un
ank.exeque 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 -cen 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ón
0.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 commit
8310e75 - 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 skill
skill 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:
| Plataforma | npm | curl | sh | PowerShell |
|---|---|---|---|
| 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
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@ankpi
El paquete npm lleva la skill junto al binario. pi carga recursos y no pone
anken tuPATH: instala también el binario.pi install npm:@haksolot/ankA mano
Copia
skill/SKILL.mddonde tu harness lo cargue. Cada skill es un solo archivo sin nada generado: no pierdes nada.
Instalar ank
Dos comandos. Linux, macOS y Windows, con git 2.34 o posterior.
npm install -g @haksolot/ank
npx skills add haksolot/ank