Installation

Asagiri est une CLI Go qui relie specs, investigation locale, worktrees Git, agents de codage externes et commandes de validation. La voie d’installation est réfléchie : vous obtenez un binaire unique, le pointez sur un dépôt, et l’outil gère le cycle de vie des runs, worktrees et état sur disque. Cette page couvre la compilation ou le placement du binaire, l’initialisation .asagiri/ dans un projet, et la confirmation que Git, la config et les commandes agents s’alignent avant un work.

Prérequis

Optionnel : Ollama pour enrichissement local ou routage, et jeton Notion pour la synchro (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install asa
asa version

La formule est publiée dans LaProgrammerie/homebrew-tap à chaque tag de release.

Installation manuelle (binaire publié)

Téléchargez archives et sommes depuis GitHub Releases. Noms d’archives type GoReleaser : asa_Darwin_arm64.tar.gz, asa_Linux_x86_64.tar.gz, asa_Windows_arm64.zip, etc.

VERSION=v0.1.0
curl -LO "https://github.com/LaProgrammerie/asagiri/releases/download/${VERSION}/checksums.txt"
curl -LO "https://github.com/LaProgrammerie/asagiri/releases/download/${VERSION}/asa_Darwin_arm64.tar.gz"
sha256sum -c checksums.txt
tar -xzf asa_Darwin_arm64.tar.gz
sudo install -m 755 asa /usr/local/bin/asa
asa version

Adaptez VERSION, le nom d’archive et le chemin d’installation à votre OS et CPU.

Installation depuis les sources

Clonez le dépôt, compilez avec le Makefile du projet et utilisez le binaire sous bin/ :

git clone https://github.com/LaProgrammerie/asagiri.git
cd asagiri
make build
./bin/asa version

Ajoutez bin/ au PATH, ou copiez bin/asa dans tout répertoire déjà présent dans PATH.

Initialiser un dépôt

Depuis la racine de votre projet, lancez asa init. La commande génère la surface locale Asagiri pour que les commandes suivantes partagent un fichier de configuration et une base SQLite.

asa init

Crée :

• .asagiri/ — config, état SQLite, runs, worktrees
• .asagiri/config.yaml — copie de config.yaml.example lorsqu’il manque
• .asagiri/state.sqlite — suivi runs et tâches

Listez .asagiri/state.sqlite et .asagiri/worktrees/ dans .gitignore. init rappelle qu’ils ne doivent pas être versionnés.

Vérifier l’installation

Après toute voie d’installation (Homebrew, binaire release ou make build), exécutez asa doctor. Doctor vérifie Git, la présence de la config, la résolution des commandes agents sur PATH, et signale les pièges fréquents avant de passer du temps sur un work bloqué.

asa doctor

Corrigez ce qu’il signale avant d’utiliser work.

Configuration

Copiez l’exemple et éditez-le pour agents, budgets ou routage personnalisés :

cp .asagiri/config.yaml.example .asagiri/config.yaml

Pour chaque bloc YAML et défaut par défaut, voir Fichier de configuration.

Étapes suivantes

Poursuivez avec Démarrage rapide, puis enchaîne un run bout en bout avec Premier workflow.