CLI-Überblick
Asagiri-Befehlsfamilien und verlinkte Flag-Referenz (generiert).
CLI-Überblick
Die asa-Binärdatei (application/cmd/asa) ist die zentrale Oberfläche: Projekt initialisieren, die spezgetriebene Pipeline in konkrete Verben aufteilen, Kost-Artefakte inspizieren und Betriebspflege erledigen. Im Alltag verläuft der Datenstrom oft über work, wenn natürliche Sprache eine ganze Pipeline abbilden soll, oder über benannte Schritte wie plan, dev und verify, wenn .kiro/specs/<feature>/ bereits Struktur liefert. Die Gruppierung unten ordnet die Begriffe — verbindliche Flags und der Unterbefehlsbaum stammen aus Cobra und stehen in der generierten CLI-Referenz; nach strukturellen CLI-Änderungen Docgen ausführen.
Globales Verhalten
Simulations-Flags verhalten sich über verschachtelte Subbefehle konsistent:
| Flag | Beschreibung |
|---|---|
--dry-run | Simuliert ohne echte Agents oder Validierungs-Shells |
| (persistent) | Wird an abgeleitete Befehle vererbt |
Umgebungsvariablen wie ASA_DRY_RUN=1 und ASA_YES=1 spiegeln gängige Schalter; die vollständige Liste steht unter Umgebungsvariablen.
Befehlsgruppen im Überblick
| Gruppe | Befehle | Typische Nutzung |
|---|---|---|
| Bootstrap | init, doctor, version | Ersteinrichtung, Gesundheitschecks |
| Pipeline | spec, plan, enrich, dev, verify, review, pr | Schritte rund um .kiro/specs/<feature>/ |
| Intent | work, continue, next, inbox | Natürliche Sprache, Fortsetzung, Überblick |
| Sources | sync, index | Fremdquellen (z. B. Notion), lokaler Index |
| Kosten / Kontext | estimate, investigate, context, cost, cost-report, cost-models | Schätzung, Investigation, Kontextpakete |
| Inspect | inspect (diff, symbol, tests) | Gezielte lokale Untersuchung |
| Ops | status, resume, report, clean | Lauflebenszyklus und Artefakte |
| MCP | mcp, mcp-serve | Optionale MCP-Anbindung |
| Meta | docs, help | Doku-Generierung, eingebaute Hilfe |
Die Tabelle ist eine Orientierung — keine Aussage darüber, welche Befehle nur interaktiv und welche in Skripten gehören.
Generierte Detailreferenz
Kurzüberblicke und deutschsprachige Stub-Seiten für ausgewählte Befehle liegen unter CLI generiert. Nach Änderungen an Cobra:
go run ./application/cmd/asa docs generate-cli \
--output docs-site/content/docs/en/cli/generatedÄnderungen an den generierten MDX-Dateien zusammen mit dem Code einreichen; die vollständigste Referenztiefe bleibt auf Englisch unter /docs/cli/generated.
Erste Befehle zum Ausprobieren
Minimaler Check vor dem Anbinden externer Agents:
asa init
asa doctor
asa work "my feature" --dry-run --plan-onlyDanach Schnellstart und bei konfigurierten Hooks Erster Workflow.