chorus-cli — utiliser la CLI chorus

chorus (publié sous @chorus-aidlc/chorus) est la commande unique qui configure les agents de codage de cette machine pour Chorus et communique avec le point de terminaison MCP Chorus depuis le shell. Ceci est une référence concise — exécutez chorus --help et chorus <command> --help pour la surface complète des flags.

1. Installation

npm install -g @chorus-aidlc/chorus       # unpinned — installe toujours la dernière version
chorus --version                          # doit être >= 0.17.0 (fournit `chorus agents` + `chorus mcp`)

2. Configurer les agents — chorus agents

La configuration des agents se trouve dans ~/.chorus/daemon.json ; chorus agents est le groupe CRUD :

• chorus agents (ou chorus agents list) — lister les agents configurés (nom, UUID, backend). La clé API n'est jamais affichée ; l'agent nommé par CHORUS_AGENT_PROFILE est marqué.
• chorus agents add [--agents <ids>] [--all] [--url <u>] [--api-key <cho_…>] [--yes] [--dsh-profile <name>] — détecter les agents de codage installés, installer le plugin Chorus de chacun, et initialiser les credentials (ancienne commande chorus init). Idempotent ; sûr de réexécuter. --help liste tous les flags.
• chorus agents remove <name|uuid> — supprimer un agent configuré de ~/.chorus/daemon.json (recherche par UUID ou nom ; un nom ambigu → utiliser l'UUID).

3. Variables d'environnement de connexion

• CHORUS_URL — l'URL de l'instance Chorus.
• CHORUS_API_KEY — une clé API d'agent (cho_…).
• CHORUS_AGENT_PROFILE — nom ou UUID optionnel de l'agent à incarner. Quand défini, chorus mcp résout la clé de cet agent depuis ~/.chorus/daemon.json, vous n'avez donc pas besoin d'exporter CHORUS_API_KEY pour le chemin CLI. Les sessions réveillées par le daemon la reçoivent automatiquement. (dsh nettoie les env en forme de credential des sous-processus d'outils ; le wrapper dsh doc-mirror lit aussi CHORUS_AGENT_PROFILE / credentials depuis $DSH_HOME/.env.)

4. Opérations MCP — chorus mcp

Appelez n'importe quel outil MCP Chorus depuis le shell — un chemin byte-exact, sans token, pour les gros contenus :

• chorus mcp call <tool> ['<json>'] [--arg-file key=<file>] [--agent <name|uuid>] — appeler un outil. --arg-file content=<file> streame les bytes bruts d'un fichier dans la chaîne JSON content (pas de resaisie via le modèle). La résolution d'identité se fait via --agent → CHORUS_AGENT_PROFILE → CHORUS_URL+CHORUS_API_KEY → un agent configuré unique.
• chorus mcp whoami — afficher l'UUID propre de cet agent.
• chorus mcp list — lister les outils que cet agent peut appeler.

Requiert chorus >= 0.17.0 (la sous-commande chorus mcp). Voir chorus mcp --help.