メニュー
Use when you need to share a screenshot with OpenCode running on a remote NixOS host (devbox or cloudbox) over SSH, since Ctrl+V image paste doesn't work remotely
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Use on any NixOS host (devbox on Hetzner, cloudbox on GCP) when SSH connection fails, host key mismatch, NixOS issues, CPU/IO contention (high load), or verifying the host is properly configured
Launch headless opencode sessions from CLI. Use when you need to start a new opencode session in the background to work on a task in parallel, or when spawning work on a specific directory.
How to apply configuration changes to NixOS hosts (devbox, cloudbox). Use when you need to rebuild the system, apply home-manager changes, or recover from issues.
Use when setting up or rotating PagerDuty MCP auth for OpenCode on macOS Keychain or cloudbox sops, or when debugging missing PagerDuty tools.
Use when setting up or rotating Rollbar MCP auth for OpenCode on macOS Keychain or cloudbox sops, when triaging a Rollbar error paged via PagerDuty, or when debugging missing Rollbar tools.
Documents the OpenCode agent set — what each does, when to use it, and why the others were cut. Use when questioning agent choices or considering adding/removing agents.
| name | screenshot-to-remote-opencode |
| description | Use when you need to share a screenshot with OpenCode running on a remote NixOS host (devbox or cloudbox) over SSH, since Ctrl+V image paste doesn't work remotely |
OpenCode supports pasting images from the clipboard with Ctrl+V, but this only works when the agent can access the local OS clipboard. Over SSH, the remote opencode process can't see your Mac's clipboard.
Solution: Take a screenshot locally, upload it to the remote NixOS host
(devbox or cloudbox), and reference the path. The screenshot-to-devbox
helper script is named for historical reasons but the mechanism is generic
to any remote SSH'd opencode session. The remote upload directory
(~/.cache/claude-images/) is also a historical name -- nothing reads
it that requires that exact path; renaming would just churn the script
and existing remote contents.
From your Mac terminal (not inside SSH):
screenshot-to-devbox
Or use the alias:
ssdb
This will:
~/.cache/claude-images/ on devboxThen in your SSH'd opencode session:
Analyze this image: /home/dev/.cache/claude-images/screenshot-20240115-143022-12345-67890.png
| Variable | Default | Description |
|---|---|---|
DEVBOX_HOST | devbox | SSH host alias |
SCREENSHOT_REMOTE_DIR | ~/.cache/claude-images | Remote directory for uploads (historical name) |
The script:
screencapture -i -x to capture a selection silentlyscp and sets 600 permissions on the filepbcopy"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.
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.