Claudeboard

Share images with Claude Code running on a remote server via Remote-SSH. Upload clipboard images instantly and get shareable file paths for seamless Claude Code workflows.

✨ Features

🖼️ Instant clipboard upload - Press Ctrl+Alt+V to upload any image from clipboard
🌍 Cross-platform support - Works on Windows, Linux, and macOS
🔗 Smart path insertion - Automatically pastes file paths in editor or terminal
🌐 Remote-SSH integration - Seamlessly works with VS Code Remote-SSH
🧹 Configurable auto-cleanup - Set retention period (0-365 days, 0 = never delete)
⚡ Real-time progress - Visual feedback during upload process
🔐 Secure by design - Uses your existing SSH connections
🎯 Dual context - Works in both code editors and integrated terminals

🚀 Quick Start

Step 1: Prerequisites

Install VS Code Remote-SSH extension
Connect to your remote server
Open a workspace folder on the remote server

Step 2: Upload Images

Copy any image to clipboard (screenshot, file copy, web image)
Press Ctrl+Alt+V in VS Code editor or terminal
Watch the magic - Image uploads instantly and path is pasted
Done! Your image is now accessible at the inserted file path

💡 Claude Code Tip: The generated file paths can be directly shared with Claude Code for image analysis, making it perfect for discussing screenshots, diagrams, or visual debugging.

🌐 Upload Destination

Remote Server Upload

Location: .claude/claude-code-chat-images/ in workspace root
Automatic cleanup: Files older than 30 days are automatically deleted
Git ignored: Images are automatically excluded from git commits
Secure: Uses existing Remote-SSH connection, no additional authentication needed
Returns: Full file path (e.g., /workspace/.claude/claude-code-chat-images/image_1234567890.png)

⚙️ Configuration

Go to File > Preferences > Settings and search for "Claudeboard":

Available Settings:

Keybinding

Choose your preferred keyboard shortcut:

Ctrl+Alt+V (default)
Ctrl+Shift+V
Alt+V
Ctrl+V (may conflict with normal paste)
F12

Retention Period

Control how long uploaded images are kept:

Default: 30 days
Range: 0-365 days
Special: Set to 0 to never delete images automatically

Note: The extension always inserts raw file paths for maximum compatibility.

📋 Requirements

VS Code 1.74.0 or newer
VS Code Remote-SSH extension (for remote server connections)
Active remote connection to your development server
Workspace folder opened on the remote server

Platform Support

✅ Windows - Full clipboard support via PowerShell
✅ Linux - Clipboard support via xclip or wl-clipboard
✅ macOS - Clipboard support via pbpaste

Platform-Specific Dependencies

Linux: Install xclip (X11) or wl-clipboard (Wayland)
macOS: Uses built-in pbpaste (no additional setup)
Windows: Uses built-in PowerShell (no additional setup)

🎨 Supported Formats

PNG (automatic conversion from clipboard)
Automatic cleanup after 30 days
Workspace integration with .claude/ directory structure

⌨️ Keyboard Shortcuts

Shortcut	Action	Context
`Ctrl+Alt+V`	Upload image from clipboard	Editor & Terminal
`Ctrl+V`	Normal paste (unaffected)	Editor & Terminal

Note: You can change the upload shortcut in settings. Ctrl+V always works normally for text pasting.

📦 Installation

From VS Code Marketplace (Recommended)

Open VS Code
Go to Extensions (Ctrl+Shift+X)
Search for "Claudeboard"
Click "Install"

From .vsix file

Download the latest .vsix file from Releases
Open VS Code
Press Ctrl+Shift+P and type "Extensions: Install from VSIX"
Select the downloaded .vsix file

🐛 Troubleshooting

Problem	Solution
"No remote connection detected"	Connect to remote server using Remote-SSH extension
"No workspace folder available"	Open a folder on the remote server
Image not detected	Make sure image is copied to clipboard (not just selected)
PowerShell error	Check if PowerShell is available and ExecutionPolicy allows execution
Upload timeout	Check Remote-SSH connection stability
Paste error	Make sure cursor is in text editor or terminal
File permission error	Check write permissions in workspace directory

📁 File Organization

workspace/
├── .claude/
│   └── claude-code-chat-images/
│       ├── .gitignore          # Automatically created
│       ├── image_1234567890.png
│       └── image_1234567891.png
└── your-project-files/

🛠️ Development

Want to contribute or build from source?

# Clone repository
git clone https://github.com/dkodr/claudeboard.git
cd claudeboard

# Install dependencies
npm install

# Development workflow
npm run compile     # Compile TypeScript
npm run watch      # Watch for changes
npm run package    # Create VSIX package

# Testing
code .             # Open in VS Code
# Press F5 to launch Extension Development Host

Architecture

TypeScript with strict mode for type safety
Service-based architecture for maintainability
Cross-platform clipboard abstractions
Result<T,E> pattern for error handling
RAII for automatic resource cleanup

🤝 Contributing

If you want to help with development:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

MIT License - see LICENSE for details.

🔗 Links

VS Code Remote-SSH - Required extension
VS Code Extensions - Marketplace
GitHub Issues - Report issues

Made with ❤️ for Claude Code and VS Code Remote Development users