hayeah/ctrlv
skills/ctrlv/SKILL.md
Saves macOS clipboard contents to files in a .ctrlv/ subdirectory. Use when the user wants to paste clipboard items (text, images, or files) to disk.
tools
Updated Apr 21, 2026
$ install --global
skillsauthnpx skillsauth add hayeah/dotfiles ctrlvInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 21, 2026, 7:27 AM51.6s7 files scanned
SKILL.md
- name:
- ctrlv
- description:
- Saves macOS clipboard contents to files in a .ctrlv/ subdirectory. Use when the user wants to paste clipboard items (text, images, or files) to disk.
ctrlv
Saves the macOS clipboard to files in a .ctrlv/ subdirectory.
Install
uv tool install -e .
Usage
ctrlv [OUTPUT_PATH]
OUTPUT_PATH defaults to ~ (home directory). Files are always written to OUTPUT_PATH/.ctrlv/, named 1.ext, 2.ext, etc. The directory is wiped on every run.
Options
| Flag | Description |
|------|-------------|
| -l, --list | Preview clipboard contents without writing |
| -a, --add | Append to .ctrlv/ instead of wiping it first |
| --ssh <host> | Rsync .ctrlv/ to the same path on a remote SSH host |
Output format
Each item is printed as one line:
1 file: /Users/me/Downloads/photo.jpg
2 text: 'hello world'
3 image (png, 204,800 bytes)
File naming
Files use their original name. Unnamed content (text, images) gets the item's index number. File name collisions get a _{i} suffix before the extension:
| Clipboard content | Written as |
|-------------------|------------|
| Text | 1.txt, 2.txt, ... |
| Image (PNG) | 1.png, 2.png, ... |
| Image (JPEG) | 1.jpg, 2.jpg, ... |
| Image (TIFF) | 1.tiff, 2.tiff, ... |
| File | original.pdf, original_2.pdf, ... |
| File (no extension) | Makefile, Makefile_2, ... |
When multiple files are copied (e.g. from Finder), each becomes a separate item.
Examples
# Paste to ~/.ctrlv/
ctrlv
# Paste to ~/Desktop/.ctrlv/
ctrlv ~/Desktop
# Preview without writing
ctrlv --list
ctrlv -l
# Append clipboard to existing .ctrlv/ (paste multiple times)
ctrlv --add
ctrlv -a
# Paste locally and rsync to remote host
ctrlv --ssh m4mini
# Paste to custom dir and rsync to remote
ctrlv ~/projects --ssh m4mini
Notes
- Reads the system pasteboard via
NSPasteboard, which includes iCloud Universal Clipboard automatically when the Mac is signed into iCloud. - Item priority per clipboard slot: file URL > image > text.
- If the same copy action produces both a file URL and a text representation (e.g. Finder copies), only the file is captured.
- With
--ssh, the remote.ctrlv/directory is synced withrsync --delete, so only the current paste contents remain on the remote.
Related Skills
hayeah/webui
tools
VerifiedTrustedCommunity
Web UI development — Vite+ toolchain setup and browser-based E2E testing workflow.
SKILL.mdUpdated Apr 24, 2026
hayeah/typescript
tools
VerifiedTrustedCommunity
Tooling and style guide for TypeScript projects.
SKILL.mdUpdated Apr 24, 2026
hayeah/tmuxcap
development
VerifiedTrustedCommunity
Capture tmux pane content and export as text, HTML, SVG, PNG, or JPG. Use when you need a screenshot or text dump of a tmux pane for sharing, feeding to AI, or archiving terminal state.
SKILL.mdUpdated Apr 24, 2026
hayeah/text-copyedit
testing
VerifiedTrustedCommunity
Copy-edit text. Fix grammar and/or tidy text into a concise listicle.
SKILL.mdUpdated Apr 24, 2026