fr

Installer ank

Deux gestes distincts : le binaire, qui est l’outil, et les skills, qui apprennent à votre agent à s’en servir. Prenez la ligne qui correspond à votre machine, puis lancez la seconde.

1Le binaire

  • npm

    Toute machine avec node. La voie qui passe un pare-feu qui bloque un exécutable nu mais laisse passer un registre.

    npm install -g @haksolot/ank

  • curl | sh

    Linux et macOS. Récupère l’archive et son .sha256, et refuse avant de décompresser si les deux ne concordent pas.

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

  • PowerShell

    Windows, sous Windows PowerShell 5.1 ou PowerShell 7. Même vérification, et il sait remplacer un ank.exe encore en cours d’exécution.

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

2Les skills

Une commande pour tous les agents. Elle détecte ceux que vous utilisez (Claude Code, Codex, Cursor, OpenCode et une trentaine d'autres) et relie chacun à une copie unique des six skills.

npx skills add haksolot/ank

Ce qu’il vous faut

Deux choses, et une troisième seulement si vous compilez depuis les sources.

git 2.34 ou plus récent
Pas un confort : les claims vivent dans des refs git, et ank vérifie la version au démarrage.
sh
Les vérificateurs tournent sous sh -c sur les trois systèmes. Sous Windows, il arrive avec Git for Windows : exiger git le rend gratuit.
Rust 1.95 ou plus récent
Uniquement pour compiler depuis les sources, avec un compilateur C à côté.

Vérifiez qu’il répond

Quelle que soit la voie choisie, demandez au binaire ce qu’il est.

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

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

Trois composantes, chacune la réponse à une question que vous vous poserez un jour :

La version0.8.0
Ce que vous avez installé. Elle est en 0.x à dessein : la boucle et les codes de sortie sont spécifiés, le format de stockage pas encore.
Le commit8310e75
Ce à partir de quoi il a été compilé. Utile la première fois que vous soupçonnez votre binaire d’être plus ancien que le comportement décrit dans la doc.
La révision du skillskill 0d916cc3d9a5
Le skill compilé avec lui. Un agent qui a chargé le skill peut comparer cette chaîne à celle qu’affiche son outil, et constater de lui-même que ses instructions sont plus anciennes que son binaire.

Mettre à jour

ank update --check lit la dernière version publiée et n'installe rien. ank update l'installe par la méthode qui a placé le binaire que vous utilisez, et affiche d'abord cette commande. Il ne touche jamais aux skills : quand leur révision change, il le signale et vous laisse les réinstaller. Aucun autre verbe n'accède au réseau pour cela.

Plateformes

Linux, macOS et Windows. Quelle voie couvre quelle machine, exactement :

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

Là où le paquet npm n’a pas de binaire, le wrapper sort avec le code 9 et indique cargo install. Là où aucune release n’en publie, curl | sh refuse en nommant la plateforme et liste ce qui existe. Aucun des deux n’échoue en silence.

Quand aucune des trois ne convient

La page des releases porte les archives que récupèrent les deux installeurs, une par cible avec son .sha256 à côté : en décompresser une à la main, c’est exactement ce qu’ils font pour vous. Et l’arbre se compile :

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

Page des releases

Aucun gestionnaire de paquets ne distribue ank. Homebrew, Scoop, apt, winget et l’AUR ont chacun eu un canal ou une tentative, et tous ont été retirés. Trois voies, toutes servies depuis le dépôt et dérivées d’une release publiée.

Les skills

Six fichiers markdown tout simples. Le premier est celui qu’un agent charge par défaut, et il se suffit à lui-même ; les cinq autres portent chacun une activité et se chargent quand le travail l’exige.

ank
Le contrat : pourquoi ank a cette forme, les commandes selon le moment où on s’en sert, les règles non négociables.
ank-plan
Transformer un objectif en ADR, specs et tâches, par entretien.
ank-drift
Confronter les décisions au code.
ank-loop
Traiter le backlog en autonomie.
ank-tdd
Mener une implémentation en test-first.
ank-diagnose
Remonter un défaut jusqu’à sa cause.

Autres façons de les installer

Chaque voie pointe vers les six mêmes fichiers dans git. Aucune ne garde une copie que quelqu’un synchronise à la main.

  • Claude Code

    En plugin : six skills et rien d’autre. Ni agent, ni hook, ni serveur, donc rien ne tourne tant que vous n’appelez pas ank.

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

  • pi

    Le paquet npm porte le skill à côté du binaire. pi charge des ressources et ne met pas ank dans votre PATH : installez aussi le binaire.

    pi install npm:@haksolot/ank

  • À la main

    Copiez skill/SKILL.md là où votre harness le charge. Chaque skill est un seul fichier, sans rien de généré : vous ne perdez rien.

Le guide d’installation complet

Installer ank

Deux commandes. Linux, macOS et Windows, avec git 2.34 ou plus récent.

npm install -g @haksolot/ank
npx skills add haksolot/ank
Lire le démarrage rapide