Commandes

Chaque verbe utilise le format collie <verb>. C'est la syntaxe canonique sur toutes les installations, implémentée directement dans le binaire (cli/). Avant d'ajouter collie à votre PATH (ci-dessous), exécutez bin/collie <verb> depuis la racine du dépôt. Sur une installation gérée par Herdr, ces mêmes verbes s'enregistrent comme des actions Herdr (ci-dessous) au comportement identique.

Si l'hôte exécute plusieurs instances, préfixez chaque verbe par COLLIE_INSTANCE=<name>. Consultez Plusieurs instances de Collie sur un même hôte.

Le CLI inclut également build, serve, unserve, doctor et crew … pour les tâches moins fréquentes.

start et status affichent tous deux la bannière Collie est en cours d'exécution : un indicateur d'état et la version, puis une ligne service, local et tailnet. Premier lancement l'affiche en entier, y compris ce qu'un échec de vérification d'état affiche à la place. La version indiquée est lue depuis l'empreinte du bundle servi, reflétant le build actif.

Ink ou texte brut. Les commandes start, status, doctor, crew add et crew status affichent une interface de terminal interactive lorsque stdout est un TTY. Passer --plain, ou rediriger la sortie vers un tube, un fichier, le journal systemd ou un exécuteur de CI, bascule sur une sortie brute ligne par ligne.

Ajoutez collie à votre PATH

Exécutez collie link pour publier ~/.local/bin/collie :

bin/collie link          # ~/.local/bin/collie → <checkout>/bin/collie
collie status            # from anywhere
bin/collie unlink        # take the name back down

Il crée un lien symbolique vers le binaire du checkout, afin que les futures mises à jour de collie build prennent effet immédiatement sans étapes supplémentaires (ADR 0021). La commande remplace les liens existants d'autres checkouts Collie et affiche celui qu'elle a écrasé. Elle refuse d'écraser les fichiers non-Collie situés à cet emplacement. unlink supprime le lien symbolique uniquement s'il cible votre checkout actuel.

Si ~/.local/bin est absent de votre PATH, link vous avertit et se termine. Il ne modifie jamais le profil de votre shell. Exécutez collie doctor pour vérifier la ligne path-link et voir vers quel checkout la commande simple collie pointe.

Actions Herdr

S'applique uniquement à une installation gérée par Herdr créé avec herdr plugin install AltanS/collie ou herdr plugin link. Herdr est l'un des trois multiplexeurs pris en charge par Collie. Ces actions correspondent directement à l'adaptateur : chaque action transmet le verbe au même binaire collie documenté dans le tableau ci-dessus. Sur les installations binaires créées via scripts/install.sh, les actions de plugin n'existent pas, et collie <verb> est la seule syntaxe.

Collie enregistre ces actions dans herdr-plugin.toml. Exécutez-les avec herdr plugin action invoke <id> --plugin herdr.collie, ou affichez-les avec herdr plugin action list --plugin herdr.collie :

qr, pair, devices, link, logs et stt n'ont pas d'action de plugin correspondante car ils nécessitent un terminal, des arguments positionnels, ou les deux. Exécutez-les sous la forme collie <verb>.

Les actions Herdr renvoient l'enveloppe JSON de Herdr au lieu de la bannière du terminal. Consultez la sortie standard (stdout) capturée de l'action avec herdr plugin log list --plugin herdr.collie, ou exécutez directement collie <verb> pour afficher la sortie en ligne. La sortie de herdr plugin list --json reflète la version mise en cache lors de plugin link, et non la version active. Pour les clones liés, update recrée automatiquement les liens pour corriger le cache. Vous pouvez forcer cette opération avec herdr plugin link "$(pwd)". Herdr ≥0.8.0 relit le manifeste sur le disque à chaque invocation.

Remarque. scripts/collie-ctl.sh <verb> reste pris en charge. Il fonctionne comme un shim d'amorçage : il localise Bun, compile bin/collie si le checkout en est dépourvu, et transmet argv. Un clone fraîchement lié utilise ce chemin pour compiler son binaire initial. Les actions Herdr continuent de pointer vers ce script car Herdr <0.8.0 fige les définitions d'actions mises en cache au moment de l'installation (ADR 0006). Chaque verbe est implémenté une seule fois dans le binaire compilé situé dans cli/.