{"id":30351355,"url":"https://github.com/dkodr/claudeboard","last_synced_at":"2026-05-09T02:36:01.524Z","repository":{"id":306251808,"uuid":"1025474589","full_name":"dkodr/claudeboard","owner":"dkodr","description":"VS Code extension for sharing clipboard images with Claude Code on remote servers via Remote-SSH. Upload screenshots instantly and get shareable file paths for seamless AI workflows.","archived":false,"fork":false,"pushed_at":"2025-07-25T22:19:39.000Z","size":43,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-18T23:02:51.516Z","etag":null,"topics":["ai","claude-code","clipboard","image-upload","productivity","remote-ssh","screenshot","typescript","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=dkodr.claudeboard","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dkodr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-24T10:00:37.000Z","updated_at":"2025-07-28T18:23:53.000Z","dependencies_parsed_at":"2025-07-24T16:53:25.591Z","dependency_job_id":"e9ab6018-074e-40ad-8ae6-4ba985e9bcc6","html_url":"https://github.com/dkodr/claudeboard","commit_stats":null,"previous_names":["dkodr/claudeboard"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/dkodr/claudeboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkodr%2Fclaudeboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkodr%2Fclaudeboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkodr%2Fclaudeboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkodr%2Fclaudeboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dkodr","download_url":"https://codeload.github.com/dkodr/claudeboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkodr%2Fclaudeboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32805073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","clipboard","image-upload","productivity","remote-ssh","screenshot","typescript","vscode-extension"],"created_at":"2025-08-18T23:01:57.383Z","updated_at":"2026-05-09T02:36:01.490Z","avatar_url":"https://github.com/dkodr.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claudeboard\n\nShare 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.\n\n## ✨ Features\n\n- 🖼️ **Instant clipboard upload** - Press `Ctrl+Alt+V` to upload any image from clipboard\n- 🌍 **Cross-platform support** - Works on Windows, Linux, and macOS\n- 🔗 **Smart path insertion** - Automatically pastes file paths in editor or terminal\n- 🌐 **Remote-SSH integration** - Seamlessly works with VS Code Remote-SSH\n- 🧹 **Configurable auto-cleanup** - Set retention period (0-365 days, 0 = never delete)\n- ⚡ **Real-time progress** - Visual feedback during upload process\n- 🔐 **Secure by design** - Uses your existing SSH connections\n- 🎯 **Dual context** - Works in both code editors and integrated terminals\n\n## 🚀 Quick Start\n\n### Step 1: Prerequisites\n- Install VS Code Remote-SSH extension\n- Connect to your remote server\n- Open a workspace folder on the remote server\n\n### Step 2: Upload Images\n1. **Copy any image to clipboard** (screenshot, file copy, web image)\n2. **Press `Ctrl+Alt+V`** in VS Code editor or terminal\n3. **Watch the magic** - Image uploads instantly and path is pasted\n4. **Done!** Your image is now accessible at the inserted file path\n\n💡 **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.\n\n## 🌐 Upload Destination\n\n### Remote Server Upload\n- **Location**: `.claude/claude-code-chat-images/` in workspace root\n- **Automatic cleanup**: Files older than 30 days are automatically deleted\n- **Git ignored**: Images are automatically excluded from git commits\n- **Secure**: Uses existing Remote-SSH connection, no additional authentication needed\n- **Returns**: Full file path (e.g., `/workspace/.claude/claude-code-chat-images/image_1234567890.png`)\n\n## ⚙️ Configuration\n\nGo to `File \u003e Preferences \u003e Settings` and search for \"Claudeboard\":\n\n### Available Settings:\n\n#### Keybinding\nChoose your preferred keyboard shortcut:\n- `Ctrl+Alt+V` (default)\n- `Ctrl+Shift+V`  \n- `Alt+V`\n- `Ctrl+V` (may conflict with normal paste)\n- `F12`\n\n#### Retention Period\nControl how long uploaded images are kept:\n- **Default**: 30 days\n- **Range**: 0-365 days\n- **Special**: Set to `0` to never delete images automatically\n\n**Note**: The extension always inserts raw file paths for maximum compatibility.\n\n## 📋 Requirements\n\n- **VS Code 1.74.0** or newer\n- **VS Code Remote-SSH extension** (for remote server connections)\n- **Active remote connection** to your development server\n- **Workspace folder** opened on the remote server\n\n### Platform Support\n- ✅ **Windows** - Full clipboard support via PowerShell\n- ✅ **Linux** - Clipboard support via `xclip` or `wl-clipboard` \n- ✅ **macOS** - Clipboard support via `pbpaste`\n\n### Platform-Specific Dependencies\n- **Linux**: Install `xclip` (X11) or `wl-clipboard` (Wayland)\n- **macOS**: Uses built-in `pbpaste` (no additional setup)\n- **Windows**: Uses built-in PowerShell (no additional setup)\n\n## 🎨 Supported Formats\n\n- **PNG** (automatic conversion from clipboard)\n- **Automatic cleanup** after 30 days\n- **Workspace integration** with `.claude/` directory structure\n\n## ⌨️ Keyboard Shortcuts\n\n| Shortcut | Action | Context |\n|----------|--------|---------|\n| `Ctrl+Alt+V` | Upload image from clipboard | Editor \u0026 Terminal |\n| `Ctrl+V` | Normal paste (unaffected) | Editor \u0026 Terminal |\n\n**Note**: You can change the upload shortcut in settings. `Ctrl+V` always works normally for text pasting.\n\n## 📦 Installation\n\n### From VS Code Marketplace (Recommended)\n1. Open VS Code\n2. Go to Extensions (`Ctrl+Shift+X`)\n3. Search for \"Claudeboard\"\n4. Click \"Install\"\n\n### From .vsix file\n1. Download the latest `.vsix` file from [Releases](https://github.com/dkodr/claudeboard/releases)\n2. Open VS Code\n3. Press `Ctrl+Shift+P` and type \"Extensions: Install from VSIX\"\n4. Select the downloaded `.vsix` file\n\n## 🐛 Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| \"No remote connection detected\" | Connect to remote server using Remote-SSH extension |\n| \"No workspace folder available\" | Open a folder on the remote server |\n| Image not detected | Make sure image is copied to clipboard (not just selected) |\n| PowerShell error | Check if PowerShell is available and ExecutionPolicy allows execution |\n| Upload timeout | Check Remote-SSH connection stability |\n| Paste error | Make sure cursor is in text editor or terminal |\n| File permission error | Check write permissions in workspace directory |\n\n## 📁 File Organization\n\n```\nworkspace/\n├── .claude/\n│   └── claude-code-chat-images/\n│       ├── .gitignore          # Automatically created\n│       ├── image_1234567890.png\n│       └── image_1234567891.png\n└── your-project-files/\n```\n\n## 🛠️ Development\n\nWant to contribute or build from source?\n\n```bash\n# Clone repository\ngit clone https://github.com/dkodr/claudeboard.git\ncd claudeboard\n\n# Install dependencies\nnpm install\n\n# Development workflow\nnpm run compile     # Compile TypeScript\nnpm run watch      # Watch for changes\nnpm run package    # Create VSIX package\n\n# Testing\ncode .             # Open in VS Code\n# Press F5 to launch Extension Development Host\n```\n\n### Architecture\n- **TypeScript** with strict mode for type safety\n- **Service-based architecture** for maintainability  \n- **Cross-platform clipboard abstractions**\n- **Result\u003cT,E\u003e pattern** for error handling\n- **RAII** for automatic resource cleanup\n\n## 🤝 Contributing\n\nIf you want to help with development:\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nMIT License - see [LICENSE](https://github.com/dkodr/claudeboard/blob/HEAD/LICENSE) for details.\n\n## 🔗 Links\n\n- [VS Code Remote-SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) - Required extension\n- [VS Code Extensions](https://marketplace.visualstudio.com/vscode) - Marketplace\n- [GitHub Issues](https://github.com/dkodr/claudeboard/issues) - Report issues\n\n---\n\n**Made with ❤️ for Claude Code and VS Code Remote Development users**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkodr%2Fclaudeboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdkodr%2Fclaudeboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkodr%2Fclaudeboard/lists"}