WCGW

What is WCGW?

WCGW is a macOS-only VS Code extension that allows users to share code snippets and terminal output with contextual information to the Claude desktop application. It is designed to work with the wcgw MCP server and provides automatic detection and attachment to WCGW screen sessions.

How to use WCGW?

After installation, select code in the editor or terminal output, press Cmd+' to send the selection with a custom instruction to Claude, or press Cmd+Shift+' to copy the selection along with broader workspace context (repo structure, frequently relevant files). The extension can automatically poll for matching WCGW screen sessions every 5 seconds and attach to them. Use the commands "WCGW: Check and Attach to Screen Sessions" or "WCGW: Toggle Screen Session Polling" for manual control.

Key features of WCGW

• Send editor selections to Claude with custom instructions and file context
• Send terminal output with workspace path and metadata
• Attach automatically to matching WCGW screen sessions
• Copy selections with context including repository structure and relevant files
• Configurable target application, polling interval, and polling enablement

Use cases of WCGW

• Share a code snippet along with its file path and workspace for Claude to analyze
• Send a terminal error log with environment details for debugging assistance
• Attach to an ongoing WCGW screen session to feed context from that terminal
• Quickly copy code with project context (package.json, Readme.md, etc.) for external use

FAQ from WCGW

Does WCGW work on Windows or Linux?

No. WCGW is macOS only due to reliance on automatic application switching via keyboard simulation.

How do I change which application receives the shared content?

Set the VS Code setting wcgw.targetApplication to the name of your target app (default is "Claude").

How do I stop automatic screen session polling?

Set wcgw.screenPollingEnabled to false or run the command "WCGW: Toggle Screen Session Polling".

What files are included when I copy with Cmd+Shift+'?

The extension includes the repository structure and frequently relevant files such as package.json, pyproject.toml, Readme.md, and at least 20 other similar files.

What are the minimum requirements to run WCGW?

macOS, VS Code version 1.85.0 or higher, and a compatible Claude desktop application.