Référence des commandes CLI

Sans sous-commande, anyy ouvre la TUI. Ses commandes publiques configurent et exploitent le profil et son Gateway résident.

Point d’entrée global

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

Les sélecteurs d’invocation --profile, --profile-root, --role et --no-color précèdent la commande. Pour la TUI par défaut, --home, --socket et --resume suivent directement anyy. Avec une sous-commande, placez ses options compatibles --home/--socket après elle ; avant, elles sont rejetées.

Option	Usage
--profile NAME	Sélectionne un profil nommé
--profile-root PATH	Remplace la racine de base du gestionnaire
--role ROLE	Choisit le rôle initial d’une nouvelle conversation
--resume ID	Ouvre une session connue dans la TUI
--home PATH	Choisit le répertoire TUI ou celui d’une commande compatible après celle-ci
--socket PATH	Choisit la socket TUI ou celle d’une commande compatible après celle-ci
--no-color	Désactive les couleurs
--version	Affiche la version

Utilisez anyy COMMAND --help pour les options exactes de la version installée.

Conversation et santé

anyy / --resume

anyy
anyy --resume SESSION_ID

Ouvre l’interface terminal, avec reprise facultative d’une session.

anyy chat

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

Envoie une nouvelle demande via un Gateway déjà actif. --session sélectionne une conversation existante ; si occupée, l’entrée rejoint son suivi. --json retourne un résultat structuré. Les outils activés s’exécutent directement. anyy --resume ID ouvre une conversation dans la TUI ; consultez Sessions pour les files.

Une réponse JSON réussie contient :

Champ	Signification
session_id	Conversation recevant l’entrée
submission_id	Entrée acceptée d’origine dont le résultat a été attendu
execution_id	Voie de session réutilisable
agent_run_id	Exécution réelle fournissant la réponse
execution_state	État observé de la voie, normalement idle après fin
outcome	Résultat de cette invocation ; succeeded indique la réussite
stop_reason	Classe de fin ou d’échec
assistant_text	Réponse visible des messages de résultat enregistrés de cette exécution

Une voie inactive seule n’est pas une réussite. Clarification (suspended), échec, interruption, entrée effacée et délai se terminent avec un code de sortie non nul sans réponse intermédiaire. Délai/annulation ne termine que l’observation. La commande conserve l’identité de soumission d’origine et ne substitue jamais les messages récents. Consultez Interface CLI.

Sélection des outils de conversation

Ces options sont acceptées pour la TUI par défaut et chat. Elles sélectionnent les outils de la session visée sans changer les défauts du Gateway ou profil.

Option	Signification
--tools LIST, -t LIST	Noms/motifs séparés par virgules ou liste de modificateurs exacts +name/-name de la sélection par défaut
--exclude-tools LIST, -xt LIST	Noms/motifs à exclure séparés par virgules
--no-tools, -nt	Supprime toute activation d’outils par défaut
--no-builtin-tools, -nbt	Supprime les intégrés par défaut en gardant ceux des extensions

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"

Les motifs simples acceptent *. Une liste de modificateurs ne peut mélanger noms simples et modificateurs ni utiliser des jokers. --tools '' est une liste explicitement vide ; --exclude-tools '' efface le remplacement d’exclusion. Placez les options avant la demande. Elles peuvent précéder ou suivre chat ; la liste locale remplace la liste globale correspondante. Elles sont rejetées pour l’administration.

Les deux suppressions sont des booléens Go séparés. Utilisez --no-builtin-tools pour les intégrés ; la syntaxe Pi --no-tools builtin n’est pas compatible. --no-tools prime si les deux sont présents. Le mode Codemode on/only est un paramètre de profil, sans option --codemode-mode.

Une nouvelle session reçoit tool_selection via session.new. Les options explicites sur une session existante invoquent d’abord session.tools.configure ; travail actif, entrée en file, admission ou résumé en attente provoquent un conflit sans nouvelle entrée. Sans remplacement, une session en mémoire garde ses noms. Restauration brute à froid et navigation lisent les déclarations canoniques de branche, distinctes d’une sélection initiale explicite de type SDK.

Consultez Sessions pour restauration d’outils, rechargement et paramètres.

Diagnostic local des demandes

anyy prompt eval local --authorize-live

Effectue des appels réels, potentiellement payants, au modèle du profil dans une session temporaire isolée. Affiche réponses, utilisation réelle et latence, et écrit un rapport privé. --home PATH choisit le profil ; --output PATH, le chemin de rapport à écriture unique. Gardez sortie et rapport privés. Ce diagnostic ne démarre ni canaux ni Cron, ne note pas la qualité et ne certifie pas l’alignement Pi.

anyy status

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

Indique l’état du profil/Gateway/environnement sélectionné.

anyy doctor

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

Exécute les diagnostics de configuration et d’environnement.

anyy config

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

Affiche au terminal chemins, fournisseur/modèle, point et état des références d’identifiants. Ne modifie rien et ne révèle pas de secrets.

Configuration et modèles

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]

Lance la configuration complète/rapide interactive ou un parcours modèle/canal ciblé. Consultez Configuration initiale.

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]

Configure les services facultatifs web, image, vidéo et voix.

Gateway et Dashboard

anyy gateway

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

Gère le service résident d’arrière-plan Gateway.

anyy dashboard

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

Démarre, inspecte ou arrête le processus auxiliaire Dashboard à la demande. Consultez Vue d’ensemble.

Messagerie

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]

Diagnostique les canaux, décide des associations, révoque des autorisations et recharge la configuration. Consultez Plateformes de messagerie.

Skills et 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]

Inspecte, installe, retire, restaure et recharge les Skills.

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]

Gère serveurs stdio/HTTP, authentification, exposition, état et appels directs. Lancez anyy mcp --help avant ajout ; les options diffèrent par transport.

add enregistre un serveur activé à connexion différée ; --disable le désactive. La configuration utilise exposition et règles ordonnées sans sélecteur ni sonde obligatoire. Le RPC tool_exposure porte une chaîne d’objet JSON ordonné. Probe donne un inventaire tools avec faits d’exposition/offre.

configure --exposure/--enable change les paramètres dans la source sélectionnée ou remplacement projet existant. configure --description/--tool-exposure et set/unset modifient le profil brut. Mélanger ces domaines est rejeté ; lancez séparément. Inspectez la source avec show.

add --cwd DIR concerne seulement stdio. Add et set SERVER_ID cwd VALUE préservent le chemin relatif, absolu ou préfixé personnel ; cwd utilise le Workspace canonique résident comme base relative.

Les écritures MCP ordinaires conservent chaîne et expressions ; un nom sensible ne déclenche pas de stockage Secret. Les références explicites de profil env:, secret: et file: gardent leurs règles.

--project s’applique seulement à enable/disable d’un serveur de profil sans remplacement et écrit un remplacement limité à l’activation. --local/-l concerne add/remove et écrit .anyy/mcp.json du Workspace canonique. L’ajout remplace sans --force ; la suppression préserve profil et autorisations. Aucun ne recharge l’entrée active. Ajout/suppression ordinaires gardent confirmation et traitement d’identifiants.

reload reconnecte sans relire. Démarrage ou RPC session.reload inactif relit profil/projet. --timeout de login vaut 300 secondes et ne limite que l’autorisation. Consultez Configuration MCP.

logout retire l’autorisation OAuth locale du serveur, données client compatibles comprises, sans supprimer sa définition. Il utilise le résident si disponible, sinon exige la propriété exclusive hors ligne.

anyy mcp serve expose Anyy à un autre client. Le résultat messages_send suit la soumission d’origine et peut signaler une clarification sans prétendre à une réponse finale. Consultez la référence de résultat et attente MCP.

Automatisation

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]

Crée des travaux agent, Skill, script ou notification. Sans type explicite, --script choisit script, sinon agent par défaut. Agent/Skill/notify exigent --prompt, script exige --script. Les destinations gateway, origin, current_user_default ou none suivent les exigences de Automatisations. Les exécutions gardent rôle, Workspace, charge et route enregistrés.

anyy heartbeat

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

Indique l’état résident Heartbeat.

Profils et rôles

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]

Gère les répertoires isolés. La suppression destructive exige --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]

Inspecte et gère les rôles d’assistant et Soul.

Sauvegarde, maintenance et cycle des versions

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]

Crée, liste ou restaure des sauvegardes. --include-secrets ajoute secrets/ et mcp/oauth/ gérés. Configuration et Workspace peuvent déjà contenir des identifiants en clair sans cette option ; la sauvegarde ne masque pas tous les fichiers. Gardez toute archive privée et sensible. Consultez Sauvegarde et restauration pour périmètre et récupération.

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]

Entretient base d’état et estimations de tokens. Précédez toute commande remplaçant l’état d’une sauvegarde vérifiée.

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]

Vérifie ou met à jour une installation native résidente. Consultez Mise à jour et désinstallation.

anyy uninstall

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

Retire une installation native. Choisissez --keep-data ou --full avant --yes/-y ; ils sont incompatibles. --home PATH choisit le répertoire d’installation ; --full supprime aussi toutes les données concernées : sauvegardez d’abord.