CLI-Befehlsreferenz

anyy öffnet ohne Unterbefehl die TUI. Seine öffentlichen Befehle konfigurieren und betreiben ausgewähltes Profil und residentes Gateway.

Globaler Einstiegspunkt

anyy [--profile NAME] [--profile-root PATH] [--role ROLE]
anyy [--profile NAME] [--profile-root PATH] [--role ROLE] COMMAND
anyy --version
anyy --resume SESSION_ID

Aufrufselektoren wie --profile, --profile-root, --role und --no-color stehen vor dem Befehl. Für die Standard-TUI folgen --home, --socket und --resume direkt auf anyy. Setzen Sie bei einem Unterbefehl dessen unterstützte Flags --home/--socket nach diesem; davor werden sie abgelehnt.

Flag	Zweck
--profile NAME	Benanntes Profil wählen
--profile-root PATH	Basisstamm des Profilmanagers überschreiben
--role ROLE	Anfängliche Rolle für neues Gespräch wählen
--resume ID	Bekannte Sitzung in TUI öffnen
--home PATH	TUI-Home wählen oder Home nach unterstützendem Befehl überschreiben
--socket PATH	TUI-Socket wählen oder Socket nach unterstützendem Befehl überschreiben
--no-color	Farbige Terminalausgabe deaktivieren
--version	Versionsinformationen ausgeben

Verwenden Sie anyy COMMAND --help für die exakten Flags der installierten Version.

Chat und Zustand

anyy / --resume

anyy
anyy --resume SESSION_ID

Terminaloberfläche öffnen, optional eine Sitzung fortsetzen.

anyy chat

anyy chat [--home PATH] [--socket PATH] [--role ROLE] \
  [--session ID] [--json] PROMPT

Einen neuen Prompt über ein bereits laufendes residentes Gateway senden. --session wählt für diesen Prompt ein vorhandenes Gespräch; bei Beschäftigung wird die Eingabe in dessen Folgenachrichten-Warteschlange eingereiht. --json liefert ein strukturiertes Ergebnis. Aktivierte Werkzeuge werden direkt ausgeführt. Verwenden Sie anyy --resume ID, um ein vorhandenes Gespräch in der TUI zu öffnen; Warteschlangensteuerung siehe Sitzungen.

Eine erfolgreiche JSON-Antwort enthält:

Feld	Bedeutung
session_id	Gespräch, das die Eingabe empfängt
submission_id	Ursprünglich angenommene Eingabe, auf deren Ergebnis gewartet wurde
execution_id	Wiederverwendbare Sitzungsspur
agent_run_id	Tatsächlicher Lauf, der die Antwort liefert
execution_state	Beobachteter Spurzustand; nach Abschluss gewöhnlich idle
outcome	Ergebnis dieses Aufrufs; succeeded ist Erfolg
stop_reason	Abschluss- oder Fehlerklassifikation
assistant_text	Sichtbare Antwort aus gespeicherten Ergebnisnachrichten dieses Laufs

Eine untätige Spur allein ist kein Erfolg. Rückfrage (suspended), Fehler, Unterbrechung, entfernte Eingabe und Zeitlimit enden ungleich null ohne Zwischenantwort des Assistenten. Zeitlimit oder Aufruferabbruch beendet nur Beobachtung. Der Befehl behält die ursprüngliche Übermittlungsidentität und ersetzt sie niemals durch neueste Sitzungsnachrichten. Siehe CLI-Oberfläche.

Gesprächswerkzeugauswahl

Die CLI akzeptiert diese Flags für Standard-TUI und chat. Sie wählen Werkzeuge der adressierten Sitzung; Gateway- oder Profilvorgaben ändern sie nicht.

Flag	Bedeutung
--tools LIST, -t LIST	Kommaseparierte Namen/Muster oder Liste exakter Modifikatoren +name/-name zur Standardauswahl
--exclude-tools LIST, -xt LIST	Auszuschließende kommaseparierte Namen/Muster
--no-tools, -nt	Mit unterdrückter Standardaktivierung aller Werkzeuge beginnen
--no-builtin-tools, -nbt	Integrierte Standardaktivierung unterdrücken, Erweiterungsvorgaben behalten

anyy --tools '+codemode,+tool_search'
anyy chat --tools 'read,bash' --exclude-tools 'bash' "Inspect this project"
anyy chat --session SESSION_ID --tools '' "Answer without tools"

Gewöhnliche Muster unterstützen *. Eine Modifikatorliste darf keine reinen Namen mit Modifikatoren mischen und keine Platzhaltermodifikatoren verwenden. Leeres --tools '' ist eine ausdrücklich leere Zulassungsliste; leeres --exclude-tools '' entfernt diese Ausschlussüberschreibung. Setzen Sie Flags vor den Prompt. Sie dürfen vor oder nach chat stehen; eine befehlslokale Liste ersetzt die entsprechende globale. Für Verwaltungsbefehle werden diese Flags abgelehnt.

Die beiden Unterdrückungsflags sind getrennte boolesche Go-Flags. Verwenden Sie für integrierte Werkzeuge --no-builtin-tools; Pis Syntax --no-tools builtin wird nicht unterstützt. --no-tools hat bei beiden vorhandenen Flags Vorrang. Codemodes on/only ist eine Profileinstellung, ohne Flag --codemode-mode.

Eine neue Sitzung erhält tool_selection über session.new. Explizite Flags an vorhandener Sitzung rufen zuerst session.tools.configure auf; aktive Arbeit, wartende Eingabe, ausstehende Aufnahme oder Zusammenfassungsarbeit erzeugen einen Konflikt, und es wird keine neue Chateingabe übermittelt. Ohne Überschreibung behält das Anbinden an eine geladene Sitzung ihre aktiven Namen. Kalte rohe Wiederherstellung und Zweignavigation verwenden kanonische Deklarationen des gewählten Zweigs; sie unterscheiden sich von expliziter SDK-Anfangsauswahl.

Werkzeugwiederherstellung, Ressourcen-Neuladen und aktuelle Sitzungseinstellungen finden Sie unter Sitzungen.

Lokale Promptdiagnose

anyy prompt eval local --authorize-live

Echte, möglicherweise kostenpflichtige Aufrufe des Modells des aktiven Profils in einer isolierten temporären Sitzung ausführen. Der Befehl gibt Antworten, tatsächlichen Verbrauch und Latenz aus und schreibt einen privaten Bericht. --home PATH wählt das Profil; --output PATH wählt den nur einmal beschreibbaren Berichtspfad. Halten Sie Terminalausgabe und Bericht vertraulich. Diese Diagnose startet weder Kanäle noch Cron und bewertet keine Modellqualität oder Pi-Konformität.

anyy status

anyy status [--home PATH] [--socket PATH] [--json]

Status von gewähltem Profil/Gateway/Laufzeit melden.

anyy doctor

anyy doctor [--home PATH] [--config PATH] [--json]

Konfigurations- und Laufzeitdiagnosen ausführen.

anyy config

anyy config [--home PATH] [--config PATH]

Konfigurationsübersicht im Terminal zeigen: Pfade, Anbieter/Modell, Endpunkt und Zugangsdatenreferenzstatus. Dieser Befehl bearbeitet weder Konfiguration noch offenbart er geheime Werte.

Einrichtung und Modelle

anyy setup

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

Interaktive vollständige/schnelle Einrichtung oder gezielten Modell-/Kanalablauf ausführen. Siehe Einrichtung.

anyy tools

anyy tools [--home PATH] [--probe]
anyy tools list [--home PATH]
anyy tools websearch [--home PATH]
anyy tools image [--home PATH] [--probe]
anyy tools image understanding [--home PATH] [--probe]
anyy tools image generation [--home PATH] [--probe]
anyy tools video [understanding] [--home PATH] [--probe]
anyy tools voice [--home PATH] [--probe]
anyy tools voice tts [--home PATH] [--probe]
anyy tools voice stt [--home PATH] [--probe]

Optionale Web-, Bild-, Video- und Sprachfähigkeits-Backends konfigurieren.

Gateway und Dashboard

anyy gateway

anyy gateway start [--home PATH]
anyy gateway restart [--home PATH]
anyy gateway status [--home PATH]
anyy gateway stop [--home PATH]

Residenten Gateway-Hintergrunddienst verwalten.

anyy dashboard

anyy dashboard [--home PATH] [--socket PATH] [--listen ADDR] [--no-open]
anyy dashboard --status
anyy dashboard --stop

Bei Bedarf gestarteten Dashboard-Begleitprozess starten, prüfen oder stoppen. Siehe Dashboard-Übersicht.

Nachrichtenkanäle

anyy channel

anyy channel doctor CHANNEL [--home PATH] [--socket PATH] [--json]
anyy channel pairing list [--channel CHANNEL] [--account ACCOUNT] [--all] [--json]
anyy channel pairing approve --request REQUEST
anyy channel pairing approve --prompt-code --channel CHANNEL --account ACCOUNT
anyy channel pairing approve --code-stdin --channel CHANNEL --account ACCOUNT
anyy channel pairing reject --request REQUEST
anyy channel pairing revoke --grant GRANT [--reason TEXT]
anyy channel reload [--home PATH] [--socket PATH] [--json]

Kanäle diagnostizieren, Kopplungsanfragen entscheiden, Berechtigungen widerrufen und Laufzeitkonfiguration neu laden. Siehe Nachrichtenplattformen.

Skills und MCP

anyy skills

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--socket PATH] [--name NAME] [--force] [--now] [--json] ZIP_PATH
anyy skills uninstall [--home PATH] [--socket PATH] [--now] [--json] NAME
anyy skills rollback [--home PATH] [--socket PATH] [--revision REVISION_ID] [--now] [--json] NAME
anyy skills reload [--home PATH] [--socket PATH] [--json]

Skills prüfen, installieren, entfernen, zurücksetzen und neu laden.

anyy mcp

anyy mcp add SERVER_ID [--home PATH] --transport stdio --command CMD [--cwd DIR] [--env KEY=VALUE] [--disable] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD [--cwd DIR] [--exposure codemode|deferred|direct|hidden] [--tool-exposure JSON] [--description TEXT] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth JSON] [--oauth JSON] [--header KEY=VALUE] [--exposure codemode|deferred|direct|hidden]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp add SERVER_ID [--home PATH] --local --url URL [--oauth JSON] [--header KEY=VALUE]
anyy mcp add SERVER_ID [--home PATH] --local --command CMD [--cwd DIR] [--env KEY=VALUE] [--args ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--exposure codemode|deferred|direct|hidden] [--enable]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--tool-exposure JSON] [--description TEXT]
anyy mcp login SERVER_ID [--home PATH] [--socket PATH] [--timeout SECONDS] [--json]
anyy mcp logout SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp remove SERVER_ID [--home PATH] --local
anyy mcp enable SERVER_ID [--home PATH] [--project]
anyy mcp disable SERVER_ID [--home PATH] [--project]
anyy mcp set SERVER_ID KEY VALUE [--home PATH]
anyy mcp unset SERVER_ID KEY [--home PATH]
anyy mcp status [--home PATH] [--socket PATH] [--json]
anyy mcp list [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER.TOOL [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER_ID TOOL_NAME [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp show SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp probe SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp test SERVER_ID [--home PATH] [--socket PATH]
anyy mcp reload [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp logs [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp serve [--home PATH] [--socket PATH]

stdio- oder HTTP-MCP-Server, Authentifizierung, bereitgestellte Werkzeuge, Laufzeitstatus und Direktaufrufe verwalten. Führen Sie vor dem Hinzufügen anyy mcp --help aus; Transportflags unterscheiden sich.

add speichert standardmäßig einen aktivierten, erst bei Bedarf verbundenen Server; --disable deaktiviert ihn. Konfiguration verwendet Bereitstellung und geordnete Überschreibungen ohne Werkzeugauswahl oder Pflichtprüfung. RPC-tool_exposure trägt ein geordnetes JSON-Objekt als Zeichenfolge. Probe meldet ein tools-Inventar mit Bereitstellungs-/Angebotsfakten.

configure --exposure/--enable ändert Einstellungen in gewählter Quelle oder vorhandener Projektüberschreibung. configure --description/--tool-exposure und allgemeines set/unset bearbeiten die rohe Profildefinition. Vermischen beider Konfigurationsbereiche wird abgelehnt; verwenden Sie getrennte Befehle. Prüfen Sie die Quelle vor Bearbeitung mit show.

add --cwd DIR gilt nur für stdio-Server. Hinzufügen und allgemeines set SERVER_ID cwd VALUE bewahren angegebenen relativen, absoluten oder mit Home beginnenden Pfad; cwd verwendet den residenten kanonischen Workspace als relative Basis.

Gewöhnliche MCP-Wertschreibvorgänge bewahren Eingabezeichenfolge und Ausdruckssyntax; ein vertraulich wirkender Feldname löst keine automatische Geheimnisspeicherung aus. Explizite Profilreferenzen env:, secret: und file: behalten ihre eigenen Auflösungsregeln.

--project gilt nur für Aktivieren/Deaktivieren eines nicht überschriebenen Profilservers und schreibt eine reine Aktivierungs-Projektüberschreibung. --local (auch -l) gilt nur für Hinzufügen/Entfernen und schreibt .anyy/mcp.json im kanonischen Workspace des Profils. Lokales Hinzufügen ersetzt den benannten Eintrag ohne --force; lokales Entfernen bewahrt Profilkonfiguration und Autorisierungen. Keine Operation lädt einen laufenden Eintrag neu. Das gewöhnliche Hinzufügen oder Entfernen von MCP-Serverdefinitionen in der Profilkonfiguration behält das Bestätigungs- und Zugangsdatenverhalten bei.

reload verbindet geladene Konfiguration neu, ohne Dateien erneut zu lesen. Start oder RPC session.reload im Leerlauf liest Profil- und Projektdateien erneut. Anmelde---timeout beträgt standardmäßig 300 Sekunden und begrenzt nur Autorisierung. Siehe MCP-Konfiguration.

logout entfernt gespeicherte lokale OAuth-Autorisierung des ausgewählten Servers einschließlich unterstützten Clientmaterials; es löscht keine Serverdefinition. Es verwendet nach Möglichkeit die residente Laufzeit, andernfalls braucht es exklusiven Offline-Profilbesitz.

anyy mcp serve stellt Anyy einem anderen MCP-Client bereit. Das messages_send-Ergebnis folgt der ursprünglichen Übermittlung und kann eine Rückfrageunterbrechung melden, ohne eine abschließende Antwort zu behaupten. Siehe MCP-Gesprächsergebnis- und Await-API-Referenz.

Automatisierung

anyy cron

anyy cron list [--home PATH] [--include-disabled] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --prompt TEXT \
  [--kind agent|skill|notify] [--skills LIST] [--role ROLE] [--workspace WORKSPACE] \
  [--delivery-target TARGET] [--delivery-channel CHANNEL] [--toolsets LIST] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --kind script --script NAME \
  [--workdir PATH] [--role ROLE] [--workspace WORKSPACE] [--delivery-target TARGET] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

Agenten-, Skill-, Skript- oder Benachrichtigungsaufträge erstellen. Ohne expliziten Typ wählt --script Skript, andernfalls ist Agent Standard. Agenten-/Skill-/Benachrichtigungsaufträge brauchen --prompt, Skriptaufträge --script. Zustellziele sind gateway, origin, current_user_default oder none unter den Routenanforderungen aus Automatisierungen. Geplante Läufe bewahren gespeicherte Rolle, Workspace, Nutzlast und Zustellroute.

anyy heartbeat

anyy heartbeat status [--home PATH] [--json]

Residenten Heartbeat-Zustand melden.

Profile und Rollen

anyy profile

anyy profile list [--json]
anyy profile get NAME [--json]
anyy profile create NAME [--display-name NAME] [--json]
anyy profile use NAME [--json]
anyy profile delete NAME --force [--purge-secrets] [--json]

Isolierte Profil-Homes verwalten. Löschen ist destruktiv und benötigt --force.

anyy role

anyy role list [--home PATH] [--include-archived] [--json]
anyy role get [--home PATH] ROLE_ID [--json]
anyy role create [--home PATH] ROLE_ID [--display-name NAME] [--json]
anyy role update [--home PATH] ROLE_ID [--display-name NAME] [--soul-file PATH] [--json]
anyy role use [--home PATH] ROLE_ID [--json]
anyy role delete [--home PATH] ROLE_ID [--json]

Assistentenrollen und Soul-Inhalt prüfen und verwalten.

Sicherung, Wartung und Versionslebenszyklus

anyy backup

anyy backup create [--home PATH] [--output PATH] [--include-secrets] [--json]
anyy backup restore --archive PATH --target-home PATH [--json]
anyy backup list [--home PATH] [--json]

Profilsicherungen erstellen, auflisten oder wiederherstellen. --include-secrets schließt zusätzlich verwaltete Verzeichnisse secrets/ und mcp/oauth/ ein. Konfiguration und Workspace-Dateien können auch ohne Flag bereits direkt enthaltene Zugangsdaten haben; Sicherung redigiert nicht jede enthaltene Datei. Halten Sie jedes Archiv privat und schützen Sie es als vertrauliche Daten. Erfassungsgrenze und Wiederherstellungsschritte siehe Sicherung und Wiederherstellung.

anyy maintenance

anyy maintenance compact-state [--home PATH] (--output PATH | --replace) [--temp-dir PATH] [--json]
anyy maintenance checkpoint-state [--home PATH] [--json]
anyy maintenance cache-token-estimates [--home PATH] [--limit N] [--execute] [--json]

Zustandsdatenbank- und Token-Schätzungswartung ausführen. Vor zustandsersetzenden Befehlen sollte eine geprüfte Sicherung erstellt werden.

anyy update

anyy update [--home PATH] [--version VERSION] [--base-url URL]
anyy update --compact [--home PATH] [--version VERSION] [--base-url URL]
anyy update --check [--home PATH] [--version VERSION] [--base-url URL]

Native residente Installation prüfen oder aktualisieren. Siehe Aktualisieren und deinstallieren.

anyy uninstall

anyy uninstall
anyy uninstall --keep-data --yes
anyy uninstall --full --yes
anyy uninstall --home PATH --keep-data --yes

Native residente Installation entfernen. Wählen Sie entweder --keep-data oder --full, bevor Sie --yes (-y) verwenden. Beides lässt sich nicht kombinieren. --home PATH wählt das Installations-Home; --full entfernt auch alle Anyy-Daten im gewählten Bereich, daher zuerst sichern.