Herdr Cheat Sheet & Quick Reference

Essentiels

$herdr

Lancer Herdr ou se connecter à la session par défaut.

$curl -fsSL https://herdr.dev/install.sh | sh
$curl -fsSL https://herdr.dev/install.sh | sh

Installer Herdr sur Linux ou macOS avec le script d'installation officiel.

$powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Installer Herdr sous Windows depuis PowerShell ; les systèmes ARM64 exécutent la version x86_64 par émulation.

$brew install herdr
$brew install herdr

Installer Herdr avec Homebrew.

$mise use -g herdr

Installer Herdr avec mise.

$herdr --remote workbox

Se connecter à une machine distante via SSH en utilisant vos raccourcis clavier locaux.

$herdr --session work

Ouvrir une session nommée au lieu de la session par défaut.

Ctrl + b q

Se détacher de l'interface TUI et laisser tous les volets en cours d'exécution.

Ctrl + b ?

Afficher tous les raccourcis clavier actifs dans le panneau d'aide.

Ctrl + b ? then /

Filtrer les actions et les raccourcis dans le panneau d'aide des raccourcis clavier.

$herdr --default-config

Afficher la configuration par défaut complète sur la sortie standard.

$herdr update

Mettre à jour une version de Herdr gérée par l'installeur depuis le canal configuré.

$brew upgrade herdr
$brew upgrade herdr

Mettre à jour Herdr installé avec Homebrew.

$mise upgrade herdr

Mettre à jour Herdr installé avec mise.

Volets

Ctrl + b v

Diviser le volet actif vers la droite.

Ctrl + b -

Diviser le volet actif vers le bas, en ouvrant un nouveau volet en dessous.

Ctrl + b h / j / k / l

Déplacer le focus vers le volet à gauche, en bas, en haut ou à droite.

Ctrl + b z

Agrandir le volet actif pour remplir l'onglet.

Ctrl + b x

Fermer le volet actif.

Ctrl + b shift + h / j / k / l

Échanger le volet actif avec le volet dans une direction.

Ctrl + b r

Entrer en mode redimensionnement pour le volet actif.

Drag

Sélectionner du texte à la souris par glisser pour le copier sans entrer en mode copie.

Onglets et Espaces de travail

Ctrl + b c

Créer un nouvel onglet dans l'espace de travail actif.

Ctrl + b n / p

Passer à l'onglet suivant ou précédent.

Ctrl + b 1..9

Accéder directement à l'onglet 1 à 9.

Ctrl + b shift + t

Renommer l'onglet actif.

Ctrl + b shift + x

Fermer l'onglet actif.

Ctrl + b shift + n

Créer un nouvel espace de travail.

Ctrl + b shift + w

Renommer l'espace de travail actif.

Ctrl + b shift + d

Fermer l'espace de travail actif.

Ctrl + b w

Entrer en navigation des espaces de travail ; quitter avec Esc ou Ctrl+[.

Ctrl + b g

Ouvrir le sélecteur Goto pour accéder à un agent ou un terminal.

Ctrl + b b

Basculer le tableau de bord de la barre latérale.

Mode Copie et Champs de texte

Ctrl + b [

Entrer en mode copie pour le volet actif.

h / j / k / l

Se déplacer par caractère ou par ligne en mode copie.

w / b / e

Se déplacer par mot en mode copie.

W / B / E

Se déplacer par grand mot en mode copie.

{ / }

Aller au paragraphe précédent ou suivant en mode copie.

PageUp / PageDown

Paginer vers le haut ou vers le bas en mode copie.

Ctrl + U / Ctrl + D

Faire défiler une demi-page vers le haut ou vers le bas en mode copie.

/ or ? then n / N

Rechercher dans l'historique du volet et répéter les correspondances.

v or Space

Démarrer une sélection en mode copie.

y or Enter

Copier la sélection active en mode copie.

q or Esc

Quitter le mode copie sans copier.

Ctrl + A / Ctrl + E

Aller au début ou à la fin d'un champ de texte Herdr.

Ctrl + U / Ctrl + K

Couper du curseur jusqu'au début ou à la fin d'un champ de texte Herdr.

Ctrl + W / Alt + Backspace / Ctrl + Backspace

Couper le mot précédent dans un champ de texte Herdr.

Alt + D

Couper le mot suivant dans un champ de texte Herdr.

Ctrl + Y

Insérer le dernier texte coupé dans un champ de texte Herdr.

Lancement, État et Machines

$herdr status

Afficher l'état global de Herdr.

$herdr status server

Afficher l'état du serveur.

$herdr --version

Afficher la version installée de Herdr.

$herdr channel show

Afficher le canal de mise à jour actuel.

$herdr channel set preview

Choisir les versions d'aperçu.

$herdr completion zsh

Générer un script de complétion pour le shell.

$herdr machine add workbox --label "Build machine"

Enregistrer un profil de machine SSH avec un libellé.

$herdr machine status "Build machine"

Vérifier l'accessibilité d'une machine enregistrée.

$herdr --machine "Build machine" agent list

Router une commande CLI vers une machine SSH enregistrée.

Sessions, Espaces de travail et Volets

$herdr session list

Lister les sessions Herdr.

$herdr session attach work

Se connecter à une session nommée.

$herdr workspace list

Lister les espaces de travail.

$herdr workspace create --cwd ~/project --label api --no-focus

Créer un espace de travail sans voler le focus.

$herdr tab create --workspace <workspace_id> --label logs

Créer un onglet dans un espace de travail avec un libellé.

$herdr tab close <tab_id>

Fermer un onglet par ID.

$herdr pane list

Lister les volets.

$herdr pane split <pane_id> --direction right --ratio 0.3

Diviser un volet vers la droite avec un ratio.

$herdr pane focus --direction left

Donner le focus au volet dans une direction.

$herdr pane read <pane_id> --source recent-unwrapped --lines 120

Lire la sortie récente du volet sans retour à la ligne.

$herdr pane run <pane_id> "npm test"

Exécuter une commande dans un volet et la soumettre avec Entrée.

$herdr pane close <pane_id>

Fermer un volet par ID.

Agents, Plugins et Intégrations

$herdr agent list

Lister les agents détectés et démarrés.

$herdr agent start reviewer --kind claude --pane <pane_id>

Démarrer un agent nommé dans un volet shell disponible.

$herdr agent prompt reviewer "review this diff" --wait

Envoyer une invite à un agent et attendre un état stabilisé.

$herdr agent wait reviewer --until idle

Attendre qu'un agent atteigne un état spécifique.

$herdr agent read reviewer --lines 80

Lire la sortie de terminal d'un agent.

$herdr agent send-keys reviewer esc

Envoyer des touches logiques à un agent.

$herdr agent focus reviewer

Donner le focus à un agent dans l'interface.

$herdr integration install claude

Installer l'intégration de l'agent Claude.

$herdr integration status --outdated-only

Afficher uniquement les intégrations dont la version est obsolète.

$herdr plugin install ogulcancelik/herdr-plugin-examples/worktree-bootstrap --yes

Installer un plugin depuis la syntaxe abrégée GitHub.

$herdr plugin list

Lister les plugins installés.

$herdr plugin action invoke <action_id>

Invoquer une action d'un plugin installé.

$herdr worktree create --cwd ~/project --branch review

Créer une copie de travail Git (worktree) en tant qu'espace de travail.

Configuration

[keys] prefix = "ctrl+a"

Modifier la touche préfixe dans la table des touches.

[keys] prefix = ["ctrl+space", "ctrl+s"]

Entrer en mode préfixe depuis plusieurs touches.

[keys] focus_pane_left = ["prefix+h", "ctrl+alt+h"]

Ajouter un raccourci direct en plus de la liaison préfixe.

[keys] switch_tab = "prefix+1..9"

Lier un saut indexé entre les onglets 1 à 9.

[theme] name = "catppuccin"

Choisir un thème intégré dans la table des thèmes.

[theme] auto_switch = true

Laisser le thème suivre l'apparence claire ou sombre du terminal.

[theme.custom] accent = "#a6e3a1"

Remplacer une seule couleur du thème.

[terminal] default_shell = "nu"

Définir l'exécutable utilisé pour les nouveaux volets interactifs.

[terminal] new_cwd = "follow"

Définir la politique de répertoire de travail pour les nouveaux volets, onglets et espaces de travail.

$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml
$notepad %APPDATA%\herdr\config.toml
$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml

Ouvrir le fichier de configuration Herdr pour le modifier.

$herdr server reload-config

Appliquer les paramètres rechargeables sans redémarrer les volets.

$herdr config reset-keys

Sauvegarder config.toml, supprimer les raccourcis clavier personnalisés. Prend effet après un redémarrage ou un rechargement.