Sandbox
Sign in
@jddev273/windows-to-wsl2-screenshots
Tools#Claude Code#Coding#Docs

Windows screenshot bridge for Claude Code in WSL2

This repo adds a screenshot bridge between Windows and WSL2. It watches for screenshots from tools like Win+Shift+S, Win+PrintScreen, and Snipping Tool, saves them under `~/.screenshots/`, and copies the resulting path to the clipboard.

94 stars•8 forks•Shell•Updated 1y ago
Who it's for

Builders who take screenshots in Windows and want to paste WSL2 file paths into Claude Code or VS Code.

What it delivers

You can share screenshots in Claude Code by pasting the file path instead of saving and copying it by hand.

What it does

Auto-save screenshots

Saves captured screenshots into `~/.screenshots/` inside WSL2.

Copy screenshot paths to clipboard

Copies the saved file path so you can paste it directly into Claude Code or VS Code.

Monitor screenshot actions

Provides start, check, and stop commands for the screenshot monitor.

Works with common Windows capture methods

Supports screenshots taken with Win+Shift+S, Win+PrintScreen, and Snipping Tool.

How to get it

  1. 1Run
    gh repo clone jddev273/windows-to-wsl2-screenshots
cd windows-to-wsl2-screenshots
source screenshot-functions.sh
check-screenshot-monitor
  2. 2Run
    # Start the automation
start-screenshot-monitor

# Check if running
check-screenshot-status

# Stop when done
stop-screenshot-monitor

README

Windows-to-WSL2 Screenshot Bridge

🚀 Auto-save Windows screenshots to WSL2 and paste paths directly into Claude Code, VS Code, or any application that uses WSL2

⭐ Star this repo if it helps you!

This tool was created to solve the annoying workflow of taking screenshots in Windows and getting them into Claude Code in WSL2. It automatically saves your screenshots and copies the file path to your clipboard so you can just Ctrl+V into Claude Code, VS Code, or any application that needs file paths.

What it does

  1. Take screenshot (Win+Shift+S, Win+PrintScreen, etc.)
  2. Auto-saves to ~/.screenshots/ in WSL2
  3. Auto-copies path to clipboard
  4. Paste into Claude Code, VS Code, or any app that uses WSL2 with Ctrl+V

Perfect for Claude Code workflows, VS Code documentation, or any development scenario where you need to quickly share screenshots.

Requirements

  • Windows 10/11 with WSL2
  • Any WSL2 distribution (Ubuntu, Debian, etc.)
  • Works with Windows Terminal (from Microsoft)

Installation

gh repo clone jddev273/windows-to-wsl2-screenshots
cd windows-to-wsl2-screenshots
source screenshot-functions.sh
check-screenshot-monitor

Usage

# Start the automation
start-screenshot-monitor

# Check if running
check-screenshot-status

# Stop when done
stop-screenshot-monitor

Now just take screenshots and paste paths directly into Claude Code, VS Code, or any application thae uses WSL2!

🎬 Demo

Screenshot showing the tool in action

The tool automatically detects screenshots, saves them, and copies the path to your clipboard - ready for instant pasting into Claude Code, VS Code, or any application that uses WSL2!

Troubleshooting

Clipboard not working?

  • Use Windows Terminal instead of basic Ubuntu terminal
  • Basic WSL terminals have clipboard sync issues

Monitor not starting?

# Check the log
cat ~/.screenshots/monitor.log

Notes

  • Tested on one system so far (mine) - your results may vary
  • Created specifically for Claude Code workflows
  • Works great with VS Code, documentation tools, any WSL2 application
  • Uses PowerShell ExecutionPolicy Bypass - required for the automation to work, only affects this specific script
  • Polls for clipboard changes was the simplest solution, you could bump up the time from 500ms if wanted.
  • Developed with Claude Code - if you need customizations or run into issues, try asking Claude Code to help modify the scripts!

Created by Johann Döwa | Made with ❤️ for the Claude Code community

Files in the repo

Repository payload•6 top-level entries
  • .gitignore
  • auto-clipboard-monitor.ps1
  • demo-screenshot.png
  • LICENSE
  • README.md
  • screenshot-functions.sh

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman
JuliusBrussee/cavemanTools

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace
MemPalace/mempalaceTools

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca
stablyai/orcaTools

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k
farion1231/cc-switchTools

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k
diegosouzapw/OmniRouteTools

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom
headroomlabs-ai/headroomTools

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k