8. Wie es innen funktioniert

8.5 Die Kommandozeile

Die Befehle der Atollo-Programmdatei, um das Kit vorzubereiten, zu prüfen und zu synchronisieren, ohne das Fenster zu öffnen.

Kurz gesagt

Die ausführbare Datei von Atollo ist auch ein Befehlszeilenprogramm: Mit einem Befehl erledigt sie die Arbeit und beendet sich, ohne das Fenster zu öffnen.
Nützlich, um ein Kit für ein anderes System vorzubereiten, die Komponenten zu prüfen oder die Umgebung anzusehen.
Funktioniert auch, während die App geöffnet ist.

So verwendest du es

Öffne eine Konsole im Kit-Ordner. Unter Windows fügst du in PowerShell | Out-Host hinzu, damit die Ausgabe in der Konsole erscheint (die ausführbare Datei ist ein Programm mit Fenster); in der Eingabeaufforderung ist das nicht nötig. Unter macOS und Linux verwendest du den Pfad des Programms (zum Beispiel ./Atollo.AppImage).

Beispiel

cd D:\Atollo
.\Atollo.exe components | Out-Host
.\Atollo.exe prepare --only node,php --line php=8.3 | Out-Host
.\Atollo.exe check | Out-Host

Die Befehle

Befehl	Was er tut
`env [--project <Name>]`	Gibt die Umgebung des Kits aus (Geheimnisse maskiert); mit einem Projekt, mit dessen Versionen.
`components [--target <System>]`	Listet die Komponenten auf: gewählt oder nicht, Gruppe, installierte Version oder warum sie nicht verfügbar ist.
`versions [<id>]`	Ohne ID: die Versionen der installierten Werkzeuge auf dem Datenträger. Mit einer ID: fragt die Quelle nach den angebotenen Versionen und speichert sie.
`check`	Fragt jede installierte Komponente nach ihrer Version und markiert ✓ oder ✗.
`check --kit`	Der Zustand des Kits: Laufwerk, Platz, Pfad, Rechte, Bibliotheken, wie „Zustand des Kits“ in den Einstellungen. Eine Zeile pro Prüfung (√, ! oder x), darunter, was zu tun ist; endet mit 1, wenn eine Prüfung ein Fehler ist.
`check --files`	Die Dateien der Programme, wie „Dateien prüfen“ auf der Seite Werkzeuge: eine Zeile pro Ordner (√ in Ordnung, x beschädigt mit den fehlenden oder geänderten Pfaden, - ohne Manifest); endet mit 1, wenn ein Ordner beschädigt ist.
`prepare [Optionen]`	Installiert, aktualisiert und entfernt Komponenten gemäß der Auswahl. Die Optionen stehen in der Tabelle unten.
`sync [--project <Ordner>] [--verbose]`	Gleicht Anweisungen, Skills und MCP-Server der Agenten ab.
`serve <Ordner> <Port>`	Stellt einen Ordner als statische Website bereit (der Dateiserver des Kits).
`keyring restore \| save`	Vom Kit rund um Antigravity verwendet: stellt dessen Anmeldung wieder her oder speichert sie.
`models`	Die lokalen Modelle: die des Katalogs und die heruntergeladenen.
`models pull <Modell>`	Lädt eine Katalog-ID oder ein Hugging-Face-Modell herunter (Eigentümer/Name:Quantisierung); setzt nach einer Unterbrechung fort.
`models rm <id>`	Löscht ein heruntergeladenes Modell.
`llm start \| stop \| status`	Der Server der lokalen Modelle (Chat und Agenten): startet ihn, stoppt ihn oder sagt, ob er antwortet. status sendet den Schlüssel nicht an das, was auf dem Port lauscht.
`diagnostics`	Erstellt das Zip für eine Problemmeldung (Geheimnisse maskiert) in data\app\diagnostics, wie „Diagnose exportieren“ in den Einstellungen, und gibt seinen Pfad aus.
`version · help`	Die Version (auch --version, -V) und die Hilfe (auch --help, -h, /?).

Option von prepare	Wirkung
`--only a,b`	Nur diese Komponenten (plus das, was sie brauchen), ohne die anderen zu entfernen.
`--skip a,b`	Alle außer diesen (die Pflichtkomponenten werden nicht übersprungen).
`--update-all`	Aktualisiert auch, was bereits installiert ist.
`--force`	Installiert neu, auch wenn die Version schon dieselbe ist.
`--line id=x.y`	Fügt diese Version neben den anderen hinzu (kann wiederholt werden).
`--target <System>`	Bereitet für ein anderes System vor: win32-x64, win32-arm64, darwin-arm64, darwin-x64, linux-x64, linux-arm64.

Unter der Haube

Exit-Code	Bedeutung
`0`	Alles in Ordnung.
`1`	prepare oder check: Etwas ist fehlgeschlagen.
`2`	Unbekannter Befehl (die Hilfe wird ebenfalls ausgegeben).
`3`	prepare: Eine andere Vorbereitung desselben Kits läuft bereits.

Auf der Befehlszeile verwendet prepare GITHUB_TOKEN oder GH_TOKEN der Konsole, falls vorhanden, um das Limit der GitHub-API anzuheben; das Konto des Kits verwendet es nicht. Wenn ein Download fehlschlägt, gibt es die Adresse zum manuellen Herunterladen und den Ordner aus, in den die Datei gehört.