claude-ss - l’outil qui colle un screenshot dans Claude Code sur macOS d’un simple `cmd+shift+2`.

claude-ss

J’ai créé un outil qui colle un screenshot dans Claude Code sur macOS d’un simple cmd+shift+2.

Contexte

Coller une simple capture d’écran dans Claude Code est plus pénible qu’on ne le pense. Si on la prend avec cmd+shift+4, un fichier est déposé sur le bureau et il faut aller le chercher pour le glisser-déposer ; même si on la copie dans le presse-papiers avec ctrl+cmd+shift+4, il faut encore changer d’onglet puis appuyer sur cmd+v.
Même si l’on veut en coller 3 d’un coup dans un même tour, le presse-papiers ne garde en mémoire que la dernière. claude-ss réduit ce processus à « raccourci → glisser → terminé ».

Fonctionnement

1. Depuis n’importe où, cmd+shift+2 → glisser pour sélectionner une zone
2. Capturer plusieurs images à la suite (elles s’empilent dans une file multi-shot)
3. Au retour dans le terminal Claude Code, elles sont automatiquement collées dans l’ordre de capture

Le démon claude-ss détecte le focus du terminal et vide la file. Pas de clignotement d’écran, pas d’écrasement du presse-papiers, pas d’enfer de changements d’apps. Même si un IME coréen/japonais/chinois est actif, le helper Swift gère automatiquement le passage en ABC → collage → restauration de l’IME d’origine.

Fonctionnalités

• File multi-shot : même avec plusieurs captures, elles sont toutes collées dans l’ordre
• IME-safe : collage fiable même quand la saisie coréenne est active
• Prise en charge de tmux / iTerm2 / cmux : ciblage fixe basé sur l’ID de session (claude-ss target set)
• Commandes slash Claude Code : contrôle manuel possible avec /ss, /ss-all, /ss-clear
• Open source MIT, gratuit

Installation

npm install -g @jidohyun/claude-ss  
claude-ss setup    # guide pour les 3 autorisations macOS  
claude-ss start  

Ou via le plugin Claude Code :

/plugin marketplace add jidohyun/claude-ss
/plugin install claude-ss@claude-ss

Liens

• GitHub: https://github.com/jidohyun/claude-ss
• npm: https://www.npmjs.com/package/@jidohyun/claude-ss

N’hésitez pas à le partager avec les utilisateurs de Claude Code ! Les retours et les PR de portage Linux·Windows sont les bienvenus.