Installation

Asagiri ist eine Go-CLI, die Specs, lokale Investigation, Git-Worktrees, externe Coding-Agenten und Validierungsbefehle verbindet. Der Installationsweg ist bewusst schlank: eine Binärdatei, ein Repository als Arbeitskontext — das Tool führt Laufzyklen, Worktrees und Persistenz auf der Platte. Diese Seite behandelt Build oder Platzierung der Binärdatei, Initialisierung von .asagiri/ und den Check von Git, Konfiguration und Agent-Befehlen vor dem ersten work.

Anforderungen

Optional: Ollama für lokales Routing oder Enrichment; Notion-Token für Sync (NOTION_TOKEN).

Homebrew (macOS / Linux)

brew tap LaProgrammerie/tap
brew install asa
asa version

Die Formel wird bei jedem Release-Tag in LaProgrammerie/homebrew-tap veröffentlicht.

Manuelle Installation (Release-Binary)

Archive und Prüfsummen von GitHub Releases laden. Archivnamen folgen GoReleaser, z. B. asa_Darwin_arm64.tar.gz, asa_Linux_x86_64.tar.gz, asa_Windows_arm64.zip.

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

VERSION, Archivname und Installationspfad an OS und CPU anpassen.

Installation aus dem Quellcode

Repository klonen, mit dem Projekt-Makefile bauen, die Binärdatei unter bin/ verwenden:

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

bin/ zum PATH hinzufügen oder bin/asa an einen Ort kopieren, der bereits auf PATH liegt.

Repository initialisieren

Vom Projektroot asa init ausführen. Der Befehl legt die lokale Asagiri-Oberfläche an, damit später alle Kommandos dieselbe Konfiguration und dieselbe SQLite-Datenbank nutzen.

asa init

Es entstehen unter anderem:

• .asagiri/ — Konfiguration, SQLite, Runs, Worktrees
• .asagiri/config.yaml — aus config.yaml.example, falls noch nicht vorhanden
• .asagiri/state.sqlite — Buchführung für Läufe und Tasks

Tragen Sie .asagiri/state.sqlite und .asagiri/worktrees/ in .gitignore ein. init erinnert daran — diese Artefakte gehören nicht ins Versionsarchiv.

Einrichtung prüfen

Nach jeder Installationsart (Homebrew, Release-Binary oder make build): asa doctor. Der Befehl prüft Git, die Existenz der Konfiguration, ob Agent-Befehle auf PATH auflösbar sind, und häufige Fehlkonfigurationen — bevor Sie Zeit in einen fehlschlagenden work-Lauf investieren.

asa doctor

Gemeldete Punkte beheben, bevor Sie work ausführen.

Konfiguration

Bei Bedarf die Beispieldatei kopieren und anpassen:

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

Alle Blöcke und Defaults: Konfigurationsdatei.

Nächste Schritte

Weiter mit Schnellstart, dann ein durchgängiger Ablauf unter Erster Workflow.