Aller au contenu

ht claude

Les verbes derrière l’intégration Claude Code. Ajoutés en 0.5.0 (statusline / sessions / event) et 0.6.0 (install / uninstall / doctor).

Fenêtre de terminal
ht claude statusline

Ne s’appelle pas à la main — installez-la comme statusline de Claude Code :

~/.claude/settings.json
{ "statusLine": { "type": "command", "command": "ht claude statusline" } }

Lit le JSON que Claude Code envoie sur stdin, imprime une ligne de statut au style τ-mux (modèle · effort · dossier · branche git · mode de permission · PR · barre de contexte · coût · ±lignes · alertes de rate-limit ≥80 %), et reverse les données parsées à l’app (claude.statusline) pour que le ticker de la barre latérale et le registre de sessions restent exacts. L’impression a toujours lieu et vient toujours en premier — une app absente ou bloquée ne dégrade jamais la ligne ; le code de sortie est toujours 0.

Fenêtre de terminal
ht claude pane [--cwd P] [--split] [--direction right|down] [--resume ID]

Ouvre un panneau Claude Code natif — le même point d’entrée que la palette de commandes, scriptable. --cwd définit le dossier de la session (par défaut celui du panneau focalisé), --split l’ouvre à côté du panneau courant, --resume ID rouvre une session précédente. À l’image de agent.create pour le panneau pi.

Fenêtre de terminal
ht claude auto-approve # état
ht claude auto-approve on # accepter automatiquement
ht claude auto-approve off
ht claude auto-approve on --delay 300

Active ou désactive l’acceptation automatique des invites de permission terminal de Claude Code. S’applique immédiatement et persiste — c’est le même réglage que Réglages → Auto-approve Claude Code prompts et que la bascule de la palette.

--delay fixe la pause avant l’envoi d’Entrée (ms). L’invite est revérifiée à l’expiration du délai : une invite que vous avez répondue vous-même ne reçoit jamais de frappe parasite.

Seule l’invite propre de Claude Code dans le terminal est répondue — jamais la modale τ-mux, jamais le panneau Claude Code. Au-delà de huit invites par minute, le système se met en pause et vous notifie ; chaque approbation est inscrite dans le journal du panneau.

Fenêtre de terminal
ht claude approve [--surface S]

Accepte l’invite de permission que Claude Code affiche dans un panneau terminal en envoyant Entrée. Sans --surface, répond à la session qui attend depuis le plus longtemps. Refuse (avec un motif) si rien n’attend, si l’approbation a été routée vers la modale τ-mux, ou s’il s’agit d’un panneau Claude Code.

Fenêtre de terminal
ht claude sessions # sessions actives
ht claude sessions --all # inclut celles terminées récemment

Liste les sessions Claude Code observées par l’app : id court, phase (working / waiting-input / waiting-approval / compacting / error), panneau, titre, et (modèle · ctx% · coût · turn N).

Fenêtre de terminal
ht claude install [--features lifecycle,tasks,statusline,approvals]
[--dry-run] [--settings-path P] [--bridge-path P]
ht claude uninstall

Chirurgie gérée de ~/.claude/settings.json :

  • sauvegarde horodatée à côté du fichier avant chaque écriture ;
  • fusion additive — vos propres entrées ne sont jamais touchées ;
  • idempotent — une seconde installation affiche des lignes = unchanged ;
  • refuse de réécrire un fichier qu’il ne peut pas parser ;
  • une statusLine définie par l’utilisateur est conservée (signalée, pas écrasée).

Fonctionnalités par défaut : lifecycle,tasks,statusline. approvals est opt-in — elle câble le hook PermissionRequest qui route les demandes de permission vers une modale τ-mux + Telegram (voir la page d’intégration pour le contrat fail-safe). uninstall retire exactement les entrées gérées (identifiées par leur chemin de commande) et garde une sauvegarde.

Fenêtre de terminal
ht claude doctor

Bilan de santé en un écran : binaire claude + version, état de parse du fichier de réglages, présence du pont, hooks câblés vs manquants, état des approbations, statusline (ht claude statusline / définie par l’utilisateur / absente), présence de la skill, et joignabilité de l’app — y compris le cas précis « joignable mais pré-0.5.0 — redémarrez τ-mux ».

Fenêtre de terminal
ht claude event --json '<JSON d'événement du pont>'

Interne — le transport du pont de hooks vers claude.event. Injecte HT_SURFACE comme attribution de panneau quand la charge utile n’en a pas.