convez.ai
SkillDevOps & InfraestruturaAvançado
AlexZeitler

Claude SSH Image Skill

AlexZeitler/claude-ssh-image-skill

Cole imagens da clipboard local em Claude Code remoto via SSH

Ver no GitHub
BomPluginScore · de 0 a 100

Skill para Claude Code que permite colar imagens da clipboard local em sessões remotas via SSH, usando um daemon local e cliente remoto que se comunicam por túnel reverso. Resolve a limitação nativa do Claude Code de não suportar images sobre SSH.

Instalação

$npx convez-ai AlexZeitler/claude-ssh-image-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
33
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Colar screenshots em sessões de Claude Code em servidores remotos
  • Compartilhar imagens de UI/UX para análise e debug remoto
  • Integrar imagens em fluxos de trabalho de desenvolvimento servidor

Veredito

Solução engenhosa que preenche gap real do Claude Code sobre SSH com arquitetura cliente-daemon bem pensada. Exige setup manual e conhecimento de SSH/systemd, mas é robusto para quem trabalha em máquinas remotas regularmente.

README

A tradução para o português deste README ainda está na fila.

claude-ssh-image-skill

A Claude Code skill + local daemon that enables pasting clipboard images into a Claude Code session on a remote server over SSH.

Claude Code doesn't natively support pasting images over SSH. This project solves that with a similar approach to sshimg.nvim, but specifically for Claude Code.

How it works

Local Machine                            Remote Server (SSH)
┌──────────────────────┐                 ┌──────────────────────────┐
│  Clipboard (PNG)     │                 │  Claude Code             │
│        │             │                 │        │                 │
│        ▼             │                 │        ▼                 │
│  ccimgd (Port 9998)  │◄────────────────│  /paste-image Skill      │
│  - wl-paste          │  SSH Reverse    │  - TCP Request to ccimgd │
│  - Returns base64    │  Tunnel         │  - Receives base64 image │
│    image in response │  (Port 9998)    │  - Saves as temp file    │
│                      │                 │  - Read → Claude sees    │
└──────────────────────┘                 │    the image             │
                                         └──────────────────────────┘
  1. The /paste-image skill runs the ccimg client on the remote server, which sends a TCP request to 127.0.0.1:9998 (forwarded through the SSH reverse tunnel to the local machine)
  2. ccimgd reads the PNG image from the local clipboard (wl-paste on Wayland, xclip on X11, pngpaste on macOS)
  3. The image is returned as base64-encoded JSON
  4. ccimg saves it as a temporary PNG file and prints the path
  5. The skill uses Claude's Read tool to display the image

Requirements

  • Local machine (Linux): wl-paste (Wayland, part of wl-clipboard) or xclip (X11)
  • Local machine (macOS): pngpaste (brew install pngpaste)
  • Remote server: Claude Code
  • Building from source: Go

Building

Build both binaries (daemon + client):

./build.sh

This builds statically linked binaries for all supported platforms:

  • daemon/ccimgd-linux-amd64, daemon/ccimgd-darwin-amd64, daemon/ccimgd-darwin-arm64
  • client/ccimg-linux-amd64, client/ccimg-darwin-amd64, client/ccimg-darwin-arm64

Setup

Local machine (Linux)

cp daemon/ccimgd-linux-amd64 ~/.local/bin/ccimgd
cp daemon/ccimgd.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now ccimgd

Local machine (macOS)

cp daemon/ccimgd-darwin-arm64 /usr/local/bin/ccimgd   # or ccimgd-darwin-amd64 for Intel
cp daemon/com.ccimgd.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.ccimgd.plist

Remote server

Copy the client binary and skill to the remote server:

scp client/ccimg-linux-amd64 your-server:~/.local/bin/ccimg
scp skill/paste-image.md your-server:~/.claude/commands/paste-image.md

To avoid permission prompts each time, add this to ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(ccimg)"
    ]
  }
}

SSH connection

Connect with a reverse tunnel:

ssh -R 9998:localhost:9998 your-server

Or add to ~/.ssh/config:

Host your-server
    RemoteForward 9998 localhost:9998

Usage

In Claude Code on the remote server, copy an image to the clipboard on your local machine and run:

/paste-image

Comparison with sshimg.nvim

Aspectsshimg.nvimclaude-ssh-image-skill
ClientNeovim plugin (Lua)Claude Code skill
Daemonimgd (Port 9999)ccimgd (Port 9998)
Image transferDaemon → scp → ServerDaemon → base64 in TCP response → Client saves
Request needshost + pathNothing (empty object)
CoexistencePort 9999Port 9998 — both can run simultaneously

License

MIT

Ver o original no GitHub

Bom para

Relacionados