claude-ss - alat yang menempelkan screenshot ke Claude Code di macOS cukup sekali tekan cmd+shift+2.

claude-ss

Saya membuat alat yang bisa langsung menempelkan screenshot ke Claude Code di macOS hanya dengan sekali cmd+shift+2.

Latar belakang

Menempelkan satu screenshot ke Claude Code ternyata lebih merepotkan daripada yang dibayangkan. Jika mengambil gambar dengan cmd+shift+4, file akan tersimpan di desktop sehingga harus dicari lalu di-drag. Bahkan jika disalin ke clipboard dengan ctrl+cmd+shift+4, tetap harus berpindah tab lalu menekan cmd+v.
Kalau ingin menempelkan 3 gambar dalam satu giliran, clipboard hanya mengingat yang terakhir. claude-ss memangkas proses ini menjadi "shortcut → drag → selesai".

Cara kerja

1. Dari mana saja, tekan cmd+shift+2 → drag area
2. Ambil beberapa gambar berturut-turut (ditumpuk ke multi-shot queue)
3. Saat kembali ke terminal Claude Code, semuanya otomatis ditempel sesuai urutan pengambilan

Daemon claude-ss mendeteksi fokus terminal lalu mengosongkan queue. Tidak ada lompatan layar, tidak menimpa clipboard, dan tidak ada neraka pindah aplikasi. Bahkan saat status IME Korea/Jepang/Tionghoa aktif, helper Swift akan otomatis beralih ke ABC → tempel → memulihkan IME semula.

Fitur

• Multi-shot queue: meski mengambil beberapa gambar, semuanya ditempel berurutan
• IME-safe: aman menempel bahkan saat mode input Korea aktif
• Dukungan tmux / iTerm2 / cmux: target dikunci berdasarkan session ID (claude-ss target set)
• Slash command Claude Code: kontrol manual juga tersedia lewat /ss, /ss-all, /ss-clear
• Open source MIT, gratis

Instalasi

npm install -g @jidohyun/claude-ss  
claude-ss setup    # panduan 3 jenis izin macOS  
claude-ss start  

Atau lewat plugin Claude Code:

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

Tautan

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

Silakan bagikan ke pengguna Claude Code! Feedback / PR porting Linux·Windows sangat diterima.