claude-ss – Ein Tool, das unter macOS Screenshots mit einem einzigen `cmd+shift+2` direkt in Claude Code einklickt.

claude-ss

Ich habe ein Tool gebaut, mit dem sich unter macOS ein Screenshot mit nur einem Druck auf cmd+shift+2 direkt in Claude Code einklicken lässt.

Hintergrund

Einen einzelnen Screenshot in Claude Code einzufügen, ist umständlicher als gedacht. Wenn man ihn mit cmd+shift+4 aufnimmt, landet die Datei auf dem Desktop und man muss sie erst suchen und hineinziehen; selbst wenn man sie mit ctrl+cmd+shift+4 in die Zwischenablage kopiert, muss man noch den Tab wechseln und cmd+v drücken.
Auch wenn man in einem Zug drei Bilder einfügen möchte, merkt sich die Zwischenablage nur das letzte. claude-ss reduziert diesen Ablauf auf „Tastenkürzel → ziehen → fertig“.

Funktionsweise

1. Überall cmd+shift+2 → Bereich ziehen
2. Mehrere Aufnahmen nacheinander erfassen (werden in einer Multishot-Queue gesammelt)
3. Wenn man zum Claude-Code-Terminal zurückkehrt, werden sie automatisch in der aufgenommenen Reihenfolge eingefügt

Der claude-ss-Daemon erkennt den Terminal-Fokus und leert die Queue. Kein Bildschirmflackern, kein Überschreiben der Zwischenablage, keine Hölle aus App-Wechseln. Selbst wenn eine koreanische, japanische oder chinesische IME aktiv ist, schaltet der Swift-Helfer automatisch auf ABC um → fügt ein → und stellt anschließend die ursprüngliche IME wieder her.

Funktionen

• Multishot-Queue: Auch bei mehreren Aufnahmen werden alle der Reihe nach eingefügt
• IME-safe: Sicheres Einfügen auch bei aktivierter koreanischer Eingabe
• tmux / iTerm2 / cmux-Unterstützung: Zielbindung auf Basis der Session-ID (claude-ss target set)
• Claude-Code-Slash-Commands: Manuelle Steuerung auch per /ss, /ss-all, /ss-clear möglich
• Open Source unter MIT, kostenlos

Installation

npm install -g @jidohyun/claude-ss  
claude-ss setup    # Anleitung für 3 macOS-Berechtigungen  
claude-ss start  

Oder als Claude-Code-Plugin:

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

Links

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

Bitte teilt es mit allen, die Claude Code nutzen! Feedback / PRs für Linux- und Windows-Portierungen sind willkommen.