Interface CLI

La commande anyy ouvre la TUI par défaut et fournit aussi des commandes adaptées aux scripts pour configuration, diagnostics, administration et conversations ponctuelles.

Démarrer l’interface interactive

anyy

Anyy résout le profil actif, se connecte à son Gateway résident et ouvre le terminal. Sélectionnez un autre profil ou rôle initial avant la commande :

anyy --profile personal --role research

Reprenez directement une session connue :

anyy --resume SESSION_ID

Consultez TUI pour commandes interactives et raccourcis clavier.

Envoyer une demande

Utilisez anyy chat lorsqu’un script shell ou un programme attend une réponse sans ouvrir la TUI :

anyy chat "Summarize my current tasks"

Envoyez une nouvelle demande dans une conversation existante avec --session :

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

--session sélectionne la conversation dont l’historique sert à la demande. Si elle travaille déjà, la demande rejoint sa file de suivi. Pour l’ouvrir dans la TUI, utilisez anyy --resume SESSION_ID.

Utilisez --json pour une sortie exploitable par programme. Les outils activés s’exécutent directement via le Gateway résident, y compris les modifications d’état. Consultez Sessions pour les entrées en attente et l’interruption.

La commande attend l’entrée d’origine et son exécution réelle, même si une autre demande utilise ensuite la même session. Elle lit les messages de résultat enregistrés pour cette exécution. Un résultat --json réussi inclut submission_id, agent_run_id, outcome et le texte de réponse ; consultez les champs de résultat chat.

Si une clarification est nécessaire, la commande sort avec l’état 1 sans afficher de réponse intermédiaire. Ouvrez la session dans TUI ou Dashboard pour répondre. Échec, interruption ou effacement d’une entrée en file produit aussi un code de sortie non nul. Un délai ou une annulation arrête l’attente sans retirer la demande acceptée. Inspectez la session avant de la soumettre de nouveau.

Garder le Gateway actif

anyy chat transmet la demande par le Gateway résident. Vérifiez-le avec anyy gateway status si la commande ne se connecte pas.

Sélectionner les outils de conversation

La TUI par défaut et chat acceptent les noms d’outils à leur entrée :

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

Noms/motifs et listes exactes de modificateurs +name/-name sont deux formes distinctes. --exclude-tools retire des noms/motifs ; --tools '' définit une liste d’autorisation explicitement vide. La CLI Go utilise des indicateurs booléens séparés --no-tools et --no-builtin-tools, sans la forme facultative Pi --no-tools builtin. Consultez la référence exacte.

Les nouvelles sessions reçoivent la sélection à la création. Sur une session existante, les options explicites la configurent avant admission ; un travail actif ou en file retourne un conflit sans soumettre de nouvelle demande. Sans remplacement, une session active en mémoire garde ses noms. La restauration brute à froid/par branche lit les déclarations canoniques sans appliquer un nouveau choix initial de type SDK.

Le mode Codemode on/only est un paramètre de profil ; changer de rôle ne sélectionne pas les outils. L’activation de la recherche d’outils concerne les requêtes ultérieures de cette session. Consultez Sessions pour rechargement et restauration.

Choisir le bon profil

Les options globales précèdent la commande :

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

Option	Usage
--profile NAME	Sélectionne un profil nommé
--profile-root PATH	Utilise une autre racine de profils nommés
--role ROLE	Définit le rôle initial d’une nouvelle session
--home PATH	Oriente une commande compatible vers un répertoire de profil
--socket PATH	Remplace la socket Gateway si pris en charge
--no-color	Désactive les couleurs du terminal

Préférez --profile au quotidien. Réservez --home et --socket aux diagnostics ou installations non standard explicites.

Groupes de commandes

Objectif	Commande
Configurer Anyy	anyy setup, anyy setup model, anyy setup channel
Inspecter la santé	anyy status, anyy doctor, anyy config
Gérer l’environnement résident	anyy gateway start|restart|status|stop
Ouvrir l’interface web	anyy dashboard
Gérer les capacités	anyy tools
Gérer le travail planifié	anyy cron, anyy heartbeat status
Protéger et entretenir les données	anyy backup, anyy maintenance

Lancez anyy --help pour le catalogue installé et anyy COMMAND --help avant d’utiliser des options inconnues.

Scripts shell

Utilisez JSON lorsque la commande le propose :

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

Le mode JSON écrit un résultat structuré unique et constitue le choix stable pour l’analyse automatique. L’affichage humain peut utiliser symboles ou couleurs.

Dépannage

Symptôme	Action
anyy ouvre les mauvaises données	Placez --profile NAME avant la commande et vérifiez avec anyy status
Conversation ponctuelle sans connexion	Lancez anyy gateway status, puis anyy gateway start
Option rejetée	Lancez la sous-commande exacte avec --help ; toutes les options ne sont pas globales
Un script échoue sur la sortie formatée	Utilisez --json au lieu d’analyser l’affichage humain

Pour l’inventaire complet, consultez Référence des commandes CLI.