Befehle

Jedes Verb verwendet das Format collie <verb>. Dies ist die kanonische Syntax für alle Installationen, die direkt im Binary (cli/) implementiert ist. Bevor Sie collie zu Ihrem PATH (unten) hinzufügen, führen Sie bin/collie <verb> aus dem Wurzelverzeichnis des Repositorys aus. Bei einer von Herdr verwalteten Installation registrieren sich dieselben Verben als Herdr-Aktionen (unten) mit identischem Verhalten.

Wenn auf dem Host mehrere Instanzen laufen, stellen Sie jedem Verb COLLIE_INSTANCE=<name> voran. Siehe Mehrere Collie-Instanzen auf einem Host.

Die CLI enthält außerdem build, serve, unserve, doctor und crew … für seltenere Aufgaben.

Sowohl start als auch status geben das Collie läuft-Banner aus: einen Zustandsstatus und die Version, gefolgt von einer service-, einer local- und einer tailnet-Zeile. Erster Aufruf zeigt es vollständig an, einschließlich der Ausgabe bei einer fehlgeschlagenen Zustandsprüfung. Die gemeldete Version stammt aus dem Zeitstempel des ausgelieferten Bundles und spiegelt den aktiven Build wider.

Ink oder reiner Text. Die Befehle start, status, doctor, crew add und crew status stellen eine interaktive Terminal-Benutzeroberfläche dar, wenn stdout ein TTY ist. Durch Übergabe von --plain oder die Umleitung der Ausgabe in eine Pipe, Datei, ein systemd-Journal oder einen CI-Runner wird auf reine Zeilenausgabe zurückgegriffen.

collie doctor gibt an, welcher Zustand gelesen wurde. Seine erste Zeile nennt die Instanz (default oder der Name in COLLIE_INSTANCE) und das Zustandsverzeichnis, das es liest. Führen Sie zwei Lanes auf einem Rechner aus, prüfen Sie diese Zeile, bevor Sie dem Rest vertrauen, denn eine Shell mit der falschen COLLIE_INSTANCE liest die falsche Lane. --json liefert dieselben zwei Werte wie instance und stateDir beim Eintrag collie.

collie doctor listet Ihre Agentenprogramme auf. Jedes Programm, für das Collie ein Eingabeprofil hat, erhält eine harness-<name>-Zeile: die Datei, die Collie auf der PATH Ihrer Login-Shell ausführen würde, die von ihr ausgegebene Version und das Urteil des Profils zu dieser Version. Eine Version über dem verifizierten Bereich ist nur ein Hinweis, da Eingaben in einem Zug weiterhin als vertrauenswürdig gelten. Die Zeile warnt, wenn sich die Datei auflösen lässt, ihre Version jedoch nicht lesbar ist, beispielsweise ein Wrapper an erster Stelle in PATH, der $HOME benötigt, oder eine defekte Installation: Bis die Version lesbar ist, behandelt Collie jede Eingabe an dieses Programm als vorläufig. Ein nicht installiertes Programm zeigt not installed. In --json enthält jede Zeile außerdem harness, binary, version und profileStatus.

Die Zeile nennt die Kopie auf Ihrem PATH, da collie doctor keinen Bereich zum Auslesen hat. Eine Eingabe auf Herdr fragt das Programm ab, das in seinem Bereich läuft; ein Bereich, der eine andere Kopie ausführt, gestartet über ihren vollständigen Pfad oder in einem Projekt installiert, zeigt daher die Version dieser Kopie auf seinen Quittungen.

collie zu Ihrem PATH hinzufügen

Führen Sie collie link aus, um ~/.local/bin/collie zu veröffentlichen:

bin/collie link          # ~/.local/bin/collie → <checkout>/bin/collie
collie status            # from anywhere
bin/collie unlink        # take the name back down

Es erstellt einen Symlink zur Binärdatei des Checkouts, sodass künftige collie build-Aktualisierungen ohne zusätzliche Schritte sofort wirksam werden (ADR 0021). Der Befehl ersetzt bestehende Verknüpfungen aus anderen Collie-Checkouts und gibt aus, welche überschrieben wurde. Er verweigert das Überschreiben von Nicht-Collie-Dateien unter diesem Pfad. unlink entfernt den Symlink nur, wenn er auf Ihren aktuellen Checkout verweist.

Wenn ~/.local/bin in Ihrem PATH fehlt, gibt link eine Warnung aus und beendet die Ausführung. Ihr Shell-Profil wird nie bearbeitet. Führen Sie collie doctor aus, um die path-link-Zeile zu prüfen und zu sehen, zu welchem Checkout der einfache collie-Befehl auflöst.

Herdr-Aktionen

Gilt nur für eine über Herdr verwaltete Installation mit herdr plugin install AltanS/collie oder herdr plugin link erstellt. Herdr ist einer von fünf Multiplexern, die Collie unterstützt. Diese Aktionen bilden direkt auf den Adapter ab: Jede Aktion leitet das Verb an dieselbe in der obigen Tabelle dokumentierte collie-Binärdatei weiter. Bei Binärinstallationen über scripts/install.sh existieren keine Plugin-Aktionen, und collie <verb> ist die einzige Syntax.

Collie registriert diese Aktionen in herdr-plugin.toml. Rufen Sie sie mit herdr plugin action invoke <id> --plugin herdr.collie auf oder zeigen Sie sie mit herdr plugin action list --plugin herdr.collie an:

qr, pair, devices, link, logs, stt und config haben keine entsprechende Plugin-Aktion, da sie ein Terminal, Positionsargumente oder beides erfordern. Führen Sie sie als collie <verb> aus.

Herdr-Aktionen geben Herdr-JSON-Envelope anstelle des Terminal-Banners zurück. Zeigen Sie die erfasste Standardausgabe der Aktion mit herdr plugin log list --plugin herdr.collie an oder führen Sie collie <verb> direkt aus, um die Ausgabe inline auszugeben. Die Ausgabe von herdr plugin list --json spiegelt die während plugin link zwischengespeicherte Version wider, nicht die aktive Version. Bei verknüpften Klonen verknüpft update automatisch neu, um den Cache zu korrigieren. Sie können dies mit herdr plugin link "$(pwd)" erzwingen. Herdr ≥0.8.0 liest das Manifest bei jedem Aufruf neu von der Festplatte.

Hinweis. scripts/collie-ctl.sh <verb> wird weiterhin unterstützt. Es fungiert als Bootstrap-Shim: Es sucht Bun, kompiliert bin/collie, falls dies im Checkout fehlt, und leitet argv weiter. Ein frisch verknüpfter Klon verwendet diesen Pfad, um seine initiale Binärdatei zu erstellen. Herdr-Aktionen verweisen weiterhin auf dieses Skript, da Herdr <0.8.0 die bei der Installation zwischengespeicherten Aktionsdefinitionen einfriert (ADR 0006). Jedes Verb ist einmal innerhalb der kompilierten Binärdatei in cli/ implementiert.