OpenParable
Skip to content
← Back to skills

Screenshot To Devbox

Apps & Automation
screenshot-to-devbox

Screenshot To Devbox is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when you need to share a screenshot with Claude Code running on the devbox over SSH, since Ctrl+V image paste doesn't work remotely

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/screenshot-to-devbox/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/screenshot-to-devbox, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Screenshot to Devbox

Overview

Claude Code supports pasting images from the clipboard with Ctrl+V, but this only works when Claude Code can access the local OS clipboard. Over SSH, the remote Claude Code process can't see your Mac's clipboard.

Solution: Take a screenshot locally, upload it to the devbox, and reference the path.

Usage

From your Mac terminal (not inside SSH):

screenshot-to-devbox

Or use the alias:

ssdb

This will:

  1. Open macOS screenshot selection (crosshairs)
  2. Upload the selection to ~/.cache/claude-images/ on devbox
  3. Copy the remote path to your clipboard

Then in your SSH session with Claude Code:

Analyze this image: /home/dev/.cache/claude-images/screenshot-20240115-143022-12345-67890.png

Configuration

VariableDefaultDescription
DEVBOX_HOSTdevboxSSH host alias
SCREENSHOT_REMOTE_DIR~/.cache/claude-imagesRemote directory for uploads

How It Works

The script:

  1. Uses screencapture -i -x to capture a selection silently
  2. Generates a unique filename with timestamp and PID
  3. Creates the remote directory with 700 permissions
  4. Uploads via scp and sets 600 permissions on the file
  5. Copies the remote path to clipboard via pbcopy

Troubleshooting

"Screenshot cancelled": You pressed Escape or clicked outside the selection. This is expected behavior.

SSH connection fails: Ensure your devbox host alias is configured in ~/.ssh/config and SSH keys are set up.

Permission denied on remote: The script creates directories with umask 077 and files with 600 permissions. If the parent directory has issues, check ~/.cache permissions.

Why Not Just Use iTerm2's it2ul?

iTerm2's it2ul upload tool can be flaky inside tmux (proprietary escape sequences don't always pass through cleanly for large files). This script uses standard scp which works reliably through any tmux session.

Related