chorus-cli — utiliser la CLI chorus

chorus (publié en tant que @chorus-aidlc/chorus) est la commande unique qui configure les agents de codage de cette machine pour Chorus et communique avec l'endpoint 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 drapeaux.

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 (c'est l'ancien chorus init). Idempotent ; sûr de réexécuter. --help énumère tous les drapeaux.
• chorus agents remove <name|uuid> — supprimer un agent configuré de ~/.chorus/daemon.json (correspondance 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 à représenter. Quand défini, chorus mcp résout la clé de cet agent à partir de ~/.chorus/daemon.json, donc vous n'avez pas besoin d'exporter CHORUS_API_KEY pour le chemin CLI. Les sessions réveillées par le daemon la reçoivent automatiquement.

4. Opérations MCP — chorus mcp

Appeler n'importe quel outil Chorus MCP 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> envoie les octets bruts d'un fichier dans la chaîne JSON content (pas de re-saisie à travers le modèle). La résolution d'identité se fait depuis --agent → CHORUS_AGENT_PROFILE → CHORUS_URL+CHORUS_API_KEY → un agent unique configuré.
• 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.