About WCGW
WCGW is a macOS-only VS Code extension for sending selected code or terminal output, with workspace context and instructions, to Claude. It also detects matching WCGW screen sessions.
Key features
- 01Send editor selections with context
- 02Send terminal selections with context
- 03Add instructions to shared content
- 04Copy selections with repository context
- 05Detect and attach matching screen sessions
Use cases
- 01Share code with Claude for analysis
- 02Send terminal output with workspace details
- 03Connect VS Code to a matching WCGW screen session
MCP support
WCGW is designed to work with the wcgw MCP server. The README does not specify further MCP server management or protocol behavior.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEWCGW
A Mac only VS Code extension that helps you share code snippets with context to Claude. Designed to work with wcgw mcp https://github.com/rusiaaman/wcgw.git
Features
- Share code snippets from editor with context to Claude
- Share terminal output with context
- Add helpful instructions or descriptions for each share
- Works with editor or terminal selections
- NEW: Automatic detection and attachment to WCGW screen sessions
- NEW: Polling mechanism to automatically connect to matching screen sessions
- NEW: Custom terminal icons to distinguish WCGW screen terminals
How to Use
For Editor Content
- Select code in the editor you want to share
- Press
Cmd+'or run command "WCGW: Send Editor Selection to Application" - Enter helpful text/instructions (or press Escape for default)
- Extension will:
- Switch to Claude
- Type your instructions
- Include selected code and context information
- Press
Cmd+Shift+'to copy the selected code with additional context:- Repository structure
- Frequently relevant files (e.g., package.json, pyproject.toml, Readme.md, etc., listing at least 20 such files)
For Terminal Output
- Select text in the terminal
- Press
Cmd+'(Mac) or run command "WCGW: Send Terminal Selection to Application" - Enter helpful text/instructions (or press Escape for default)
- Extension will:
- Switch to Claude
- Type your instructions
- Include terminal output and context information
- Press
Cmd+Shift+'to copy terminal output with additional context:- Repository structure
- Frequently relevant files (e.g., package.json, pyproject.toml, Readme.md, etc., listing at least 20 such files)
For WCGW Screen Sessions
The extension automatically detects and attaches to WCGW screen sessions that match your current workspace:
- Automatic Detection: The extension polls every 5 seconds for new screen sessions
- Workspace Matching: Only attaches to sessions where the hash and basename match your current workspace
- Visual Distinction: WCGW screen terminals show with a desktop icon and "WCGW Screen: [basename]" name
- Manual Commands:
- Run "WCGW: Check and Attach to Screen Sessions" to manually check
- Run "WCGW: Toggle Screen Session Polling" to enable/disable automatic polling
Screen Session Format: Sessions must follow the pattern PID.wcgw.TIMESTAMP.HASH.BASENAME
- Example:
555.wcgw.24-15h06m22s.be7.claude_playground
Example Output
Editor Selection
Your instructions or "Here's the code to analyze."
---
Workspace path: /path/to/workspace
---
File path: /path/to/file
---
Selected code:
[your selected code]
Terminal Selection
Your instructions or "Here's the terminal output to analyze."
---
Workspace path: /path/to/workspace
---
Terminal output:
[your terminal selection]
Extension Settings
This extension contributes the following settings:
wcgw.targetApplication: Name of the application to send code to (default: "Claude")wcgw.screenPollingEnabled: Enable automatic polling for WCGW screen sessions (default: true)wcgw.screenPollingInterval: Interval in milliseconds for checking screen sessions (default: 5000)
Requirements
- macOS (required for automatic application switching)
- VS Code 1.85.0 or higher
Known Issues
- macOS only currently
Release Notes
0.4.0
Added WCGW screen session integration:
- Automatic detection and attachment to matching screen sessions
- Polling mechanism with configurable intervals
- Custom terminal icons for WCGW screen sessions
- Manual commands for checking and toggling screen polling
- Workspace-based session matching using hash and basename
0.1.0
Added features:
- Split into separate editor and terminal commands
- New keybinding (Cmd+Shift+') for terminal selections
- Improved error messages and context information
- Better formatting of output
0.0.1
Initial release with features:
- Code sharing with custom instructions
- Works with or without code selection
- File and workspace context
- Reliable text entry through keyboard simulation
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.