# Despacer : copier-coller en un seul morceau

URL: https://www.mattsenter.com/fr/blog/introducing-despacer

*Despacer est une app gratuite et open source pour la barre des menus du Mac qui répare les longues commandes copiées depuis Claude Code et Codex dans le terminal. Les deux agents coupent eux-mêmes les longues lignes avec un vrai saut de ligne et un retrait de deux espaces, si bien qu’une commande copiée se colle en morceaux et ne s’exécute pas. Despacer répare une copie du terminal en deux étapes. Ses règles de coupure retirent le retrait et recollent aussitôt les sauts causés par la coupure. Un instant plus tard, il cherche le texte copié dans les fichiers de session que Claude Code et Codex conservent sur le Mac et, s’il le trouve, place dans le presse-papiers la commande originale telle que l’agent l’a écrite. Il ignore les copies faites dans les autres apps, ne se connecte pas au réseau, ne collecte aucune donnée et ne garde en mémoire que les dix dernières corrections, pour pouvoir les annuler. Il demande macOS 14 Sonoma ou version ultérieure et, pour l’instant, s’installe en le compilant depuis le code source avec un seul script.*

J’en avais assez de copier une commande depuis Claude Code ou Codex, de la coller dans mon terminal et de la voir se disloquer. Ces sauts de ligne ne sont pas seulement visuels : ils sont copiés aussi.

J’ai donc créé Despacer, une petite app dans la barre des menus du Mac qui reconstitue les commandes coupées. Copiez et collez comme d’habitude. Elle répare les sauts de ligne et peut retrouver le texte original dans l’historique local des sessions de l’agent.

Elle est gratuite et open source, sous licence MIT. Aucun accès réseau, aucune analyse d’usage, aucune donnée collectée. Si une réparation se trompe, « Annuler la dernière correction » restaure votre copie d’origine.

## Pourquoi les longues commandes de Claude Code et Codex arrivent-elles coupées ?

Claude Code et Codex dessinent eux-mêmes leur affichage, et tous deux coupent les longues lignes à la largeur du terminal avant de les afficher. Chaque coupure est un vrai saut de ligne suivi d’un retrait de deux espaces. Le terminal ne voit jamais une seule longue ligne. Il voit, et copie, des lignes séparées.

C’est pourquoi aucun réglage du terminal n’y peut rien : les fins de ligne d’origine n’arrivent jamais jusqu’au terminal. L’exemple du README est une longue commande `curl` avec une longue URL de téléchargement. Elle se copie en quatre lignes en retrait, l’URL coupée au milieu, et elle ne s’exécute pas.

## Comment Despacer répare-t-il une copie ?

Despacer vérifie le presse-papiers 20 fois par seconde, parce que macOS ne signale pas les changements du presse-papiers. Quand une copie vient d’une app de terminal, il la répare en deux étapes. Les copies faites dans les autres apps ne sont jamais lues.

### Première étape : les règles de coupure, tout de suite

Il retire le retrait de deux espaces et les espaces en fin de ligne, puis recolle chaque saut de ligne causé par la coupure : un saut là où le mot suivant n’aurait pas tenu sur la ligne du dessus. Un mot trop long pour une ligne a été coupé au milieu, donc ce saut est recollé sans espace. Tous les autres sauts de ligne restent, tout comme chaque ligne qui se termine par une barre oblique inversée. Cette version part aussitôt dans le presse-papiers.

### Deuxième étape : une correspondance exacte, un instant plus tard

En arrière-plan, Despacer cherche le texte copié dans les fichiers de session que Claude Code et Codex conservent sur votre Mac, en ignorant les espaces et les sauts de ligne. Il parcourt les sessions actives au cours de la dernière journée, des plus récentes aux plus anciennes. S’il trouve une correspondance, il place dans le presse-papiers le texte original, tel que l’agent l’a écrit, sauf si vous avez copié autre chose entre-temps.

Les règles de coupure suffisent pour la plupart des commandes. Certaines coupures sont impossibles à distinguer, par exemple quand une sélection commence au milieu d’une ligne, et la correspondance exacte tranche ces cas.

L’app fait moins de 1 400 lignes de Swift, et le moteur de correction environ 250, avec des tests construits à partir de vraies copies cassées.

## Comment installer et configurer Despacer ?

Pour l’instant, on installe Despacer en le compilant depuis le code source. Cela prend environ une minute.

1. Installez les outils en ligne de commande d’Apple si vous ne les avez pas : `xcode-select --install`.
2. Clonez le dépôt et lancez `./build.sh --install`. Cela compile Despacer.app, le copie dans votre dossier Applications et l’ouvre.
3. Dans la fenêtre des réglages, sous « Système », activez « Ouvrir avec la session » pour que Despacer soit toujours prêt.

Les versions récentes de macOS demandent si Despacer peut lire ce que vous copiez. Choisissez « Autoriser ». Si vous avez choisi « Ne pas autoriser », changez-le dans Réglages Système > Confidentialité et sécurité > Coller depuis d’autres apps. La section « Autorisations » de Despacer propose un bouton qui vous y mène.

Ensuite, il n’y a rien de nouveau à apprendre : sélectionnez une commande, appuyez sur Cmd+C et collez. Despacer reconnaît d’emblée Terminal, iTerm2, Ghostty, Warp, kitty, Alacritty, WezTerm, Hyper, Tabby et Rio. Sous « Terminaux », vous pouvez ajouter d’autres apps, comme un éditeur de code avec un terminal intégré, ou décocher celles que vous ne voulez pas qu’il surveille.

## Ce que Despacer ne fait pas

Despacer fait un seul travail et laisse beaucoup de choses tranquilles :

- Il ne lit pas les copies des apps absentes de sa liste de terminaux.
- Il ne touche pas au texte qui n’a jamais été cassé, comme une sortie ordinaire du terminal. Il ne répare que le texte portant le retrait de deux espaces qu’affichent les agents, ou le texte qu’il retrouve mot pour mot dans leur historique de sessions.
- Il ne se connecte pas au réseau, et n’a ni compte, ni analyse d’usage, ni rapports de plantage, ni pistage.
- Il ne modifie, ne copie ni n’envoie jamais les fichiers de session des agents. Il se contente de les lire, et « Comparer à l’historique des sessions » désactive cette lecture.
- Il ne conserve pas vos corrections. Les dix dernières restent en mémoire pour que vous puissiez les annuler, et disparaissent quand Despacer quitte.

Il peut tout de même se tromper. Sans correspondance exacte, les règles de coupure doivent deviner. Si une copie ressort recollée alors qu’elle n’aurait pas dû, « Annuler la dernière correction » dans la barre des menus rétablit exactement ce que vous aviez copié, et « Corrections récentes », sous « Correction », garde les dix dernières. Si cela se répète, désactivez « Réparer les autres textes coupés » pour que Despacer ne corrige plus que ce qu’il trouve dans l’historique des sessions, et envoyez-moi le texte dans une [issue GitHub](https://github.com/MattSenter/despacer/issues) pour que les règles s’améliorent.

## Peut-on l’utiliser en ligne de commande ?

Oui. Le même moteur fonctionne aussi comme filtre en ligne de commande, pour des scripts ou pour un texte déjà collé quelque part. Compilez-le avec `swift build -c release`, puis lancez `pbpaste | .build/release/despacer | pbcopy`. Ajoutez `--explain` pour voir quelle méthode il a utilisée, ou `--no-transcripts` pour n’utiliser que les règles de coupure.

## Où trouver Despacer

Despacer fonctionne sur macOS 14 Sonoma ou version ultérieure et existe en neuf langues. Il est gratuit sous licence MIT, et il n’y a rien à acheter ni à débloquer.

Le [README en français](https://github.com/MattSenter/despacer/blob/main/README.fr.md) détaille chaque réglage, le dépannage et la désinstallation. Pour un aperçu plus court, consultez la [page du projet Despacer](https://www.mattsenter.com/fr/projects/despacer).

[Obtenir Despacer sur GitHub](https://github.com/MattSenter/despacer)
