launch-wsl-claude-session
Launch a detached, interactive Claude Code session inside WSL from a Windows Claude Code session — in a specific repo/folder, optionally remote-controllable and optionally seeded with an initial prompt. Use this WHENEVER the user wants to open / launch / spawn / start / fire off a separate (or background, detached, standalone, "and ignore it") Claude session in WSL, in a given directory, especially so it shows up in their remote Claude sessions list, even if they don't name every detail. It handles the Windows→WSL launch quirks that silently break naive attempts: ConPTY via Windows Terminal, PowerShell path passing, session-id vs initial-prompt openers, prompt quoting, and the workspace-trust gate.
- Compatibility
- Requires a Windows PC with WSL and Windows Terminal. Works whether Claude runs on the Windows host (via PowerShell) or inside the WSL distro (via bash + Windows interop). Not applicable on Claude.ai web, the mobile app, headless/remote sandboxes, macOS, or plain Linux without Windows underneath.
Pinned to revision 400fbf01d7bb, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/launch-wsl-claude-session/SKILL.md
- skills/launch-wsl-claude-session/scripts/launch-wsl-claude.ps1
- skills/launch-wsl-claude-session/scripts/launch-wsl-claude.sh
Every link opens the file at its source, pinned to the revision this page describes.