CLI-Oberfläche

Der Befehl anyy öffnet standardmäßig die TUI und bietet außerdem skriptgeeignete Befehle für Einrichtung, Diagnose, Administration und einmalige Gespräche.

Die interaktive Oberfläche starten

anyy

Anyy ermittelt das aktive Profil, verbindet sich mit dessen residentem Gateway und öffnet die Terminaloberfläche. Wählen Sie ein anderes Profil oder eine anfängliche Rolle vor dem Befehl:

anyy --profile personal --role research

Eine bekannte Sitzung direkt fortsetzen:

anyy --resume SESSION_ID

Interaktive Befehle und Tastatursteuerung finden Sie unter TUI.

Einen Prompt senden

Verwenden Sie anyy chat, wenn ein Shell-Skript oder ein anderes Programm eine Antwort benötigt, ohne die TUI zu öffnen:

anyy chat "Summarize my current tasks"

Senden Sie mit --session einen neuen Prompt in einem vorhandenen Gespräch:

anyy chat --session SESSION_ID "What should I do next?"

--session wählt das Gespräch, dessen Verlauf der neue Prompt verwendet. Ist die Sitzung beschäftigt, wird der Prompt in ihre Folgenachrichten-Warteschlange eingereiht. Zum Öffnen einer vorhandenen Sitzung in der TUI dient anyy --resume SESSION_ID.

Verwenden Sie --json für maschinenlesbare Ausgabe. Aktivierte Werkzeuge werden direkt über das residente Gateway ausgeführt, einschließlich zustandsändernder Aufrufe. Verhalten ausstehender Eingaben und Abbrüche ist unter Sitzungen beschrieben.

Der Befehl wartet auf die ursprünglich übermittelte Eingabe und ihren tatsächlichen Lauf, auch wenn später ein anderer Prompt dieselbe Sitzung verwendet. Er liest die gespeicherten Ergebnisnachrichten dieses Laufs. Ein erfolgreiches --json-Ergebnis enthält submission_id, agent_run_id, outcome und den Antworttext; siehe Chat-Ergebnisfelder.

Benötigt der Lauf eine Rückfrage, beendet sich der Befehl mit Status 1 und gibt keine Zwischenantwort aus. Öffnen Sie zum Antworten die Sitzung in TUI oder Dashboard. Fehler, Unterbrechung oder eine entfernte wartende Eingabe führen ebenfalls zu einem Exitstatus ungleich null. Ein Wartezeitlimit oder Abbruch beendet das Warten; der angenommene Prompt wird nicht zurückgezogen. Prüfen Sie die Sitzung, bevor Sie ihn erneut senden.

Gateway weiterlaufen lassen

anyy chat sendet den Prompt über das residente Gateway. Prüfen Sie es mit anyy gateway status, wenn der Befehl keine Verbindung herstellen kann.

Gesprächswerkzeuge auswählen

Die Standard-TUI und chat akzeptieren an ihren Einstiegspunkten Werkzeugnamen:

anyy --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "Inspect the project"

Namen/Muster und Listen mit exakten Modifikatoren +name/-name sind getrennte Formen. --exclude-tools entfernt Namen/Muster; --tools '' ist eine ausdrücklich leere Zulassungsliste. Die Go-CLI verwendet getrennte boolesche Flags --no-tools und --no-builtin-tools, nicht Pis optionale Form --no-tools builtin. Siehe genaue Flag-Referenz.

Neue Sitzungen erhalten die Auswahl beim Erstellen. Explizite Flags für eine vorhandene Sitzung konfigurieren sie vor Aufnahme des Prompts; beschäftigte oder wartende Arbeit liefert einen Konflikt zurück und es wird kein neuer Prompt übermittelt. Ohne Überschreibung behält eine bereits geladene Sitzung ihre aktiven Namen. Eine rohe Wiederherstellung aus kaltem Zustand oder eines Zweigs liest die kanonischen Deklarationen, statt eine neue anfängliche SDK-Auswahl anzuwenden.

Der Codemode-Modus on/only ist eine Profileinstellung; ein Rollenwechsel wählt keine Werkzeuge. Die Aktivierung durch Werkzeugsuche gilt für spätere Modellanfragen dieser Sitzung. Verhalten beim Neuladen und Wiederherstellen finden Sie unter Sitzungen.

Das richtige Profil wählen

Globale Auswahlflags müssen vor dem Befehl stehen:

anyy --profile work status
anyy --profile work chat "Show today's priorities"

Flag	Zweck
--profile NAME	Ein benanntes Profil wählen
--profile-root PATH	Einen anderen Stamm für benannte Profile verwenden
--role ROLE	Die anfängliche Rolle einer neuen Sitzung festlegen
--home PATH	Einen unterstützten Befehl auf ein Profil-Home richten
--socket PATH	Den Gateway-Socket überschreiben, sofern unterstützt
--no-color	Farbige Terminalausgabe deaktivieren

Bevorzugen Sie --profile im normalen Alltag. Verwenden Sie --home und --socket für Diagnosen oder ausdrücklich abweichende Strukturen.

Befehlsgruppen

Ziel	Befehl
Anyy konfigurieren	anyy setup, anyy setup model, anyy setup channel
Zustand prüfen	anyy status, anyy doctor, anyy config
Residente Laufzeit verwalten	anyy gateway start|restart|status|stop
Weboberfläche öffnen	anyy dashboard
Fähigkeiten verwalten	anyy tools
Geplante Arbeit verwalten	anyy cron, anyy heartbeat status
Daten schützen und warten	anyy backup, anyy maintenance

Verwenden Sie anyy --help für den installierten Katalog und anyy COMMAND --help, bevor Sie unbekannte Flags verwenden.

Shell-Skripte

Verwenden Sie JSON-Ausgabe, sofern der Befehl sie anbietet:

anyy status --json
anyy backup list --json
anyy heartbeat status --json

Der JSON-Modus schreibt ein einzelnes strukturiertes Ergebnis und ist die stabile Wahl zum Parsen. Die menschenlesbare Ausgabe ist zum Lesen gedacht und kann Symbole oder Farben verwenden.

Fehlerbehebung

Symptom	Vorgehen
anyy öffnet die falschen Daten	Setzen Sie --profile NAME vor den Befehl und prüfen Sie mit anyy status
Einmaliger Chat kann keine Verbindung herstellen	Führen Sie anyy gateway status und dann anyy gateway start aus
Ein Flag wird abgelehnt	Rufen Sie genau den Unterbefehl mit --help auf; nicht alle Flags sind global
Ein Skript scheitert an formatierter Ausgabe	Verwenden Sie --json, statt die menschenlesbare Ansicht zu parsen

Den vollständigen Befehlskatalog finden Sie unter CLI-Befehlsreferenz.