Shell and Coding agent for Claude and other mcp clients

What is Shell and Coding agent for Claude and other mcp clients?

Shell and Coding agent for Claude and other mcp clients (wcgw) is an MCP server that provides tightly integrated shell and code editing tools, enabling chat applications to code, build, and run on your local machine. It offers a fully interactive shell experience that both you and the AI agent can control, including sending keystrokes.

How to use Shell and Coding agent for Claude and other mcp clients?

Install uv (e.g., brew install uv on macOS), then add the server to your claude_desktop_config.json with the command uvx and args ["--python", "3.12", "wcgw@latest"]. Optionally force a specific shell with --shell. On Windows, use wsl.exe as the command. After configuration, restart Claude and look for the rocket icon. You can then ask Claude to execute shell commands, read/write files, run code, or use built-in modes (architect, code-writer, wcgw).

Key features of Shell and Coding agent for Claude and other mcp clients

• Create, execute, and iterate with automatic retries
• Large file incremental edits to avoid token limits
• Syntax checking on edits with feedback to the AI
• Interactive command handling with arrow keys and interrupts
• File protections: read-before-edit, chunked large files
• Task checkpointing with ContextSave tool and resume support

Use cases of Shell and Coding agent for Claude and other mcp clients

• Ask Claude to run compiler checks until all errors are fixed
• Iterate on code changes with large file edits and syntax validation
• Save task context for later resume or knowledge transfer between AIs
• Use architect mode to plan before editing, or code-writer mode to restrict edits to specific paths
• Attach to the AI’s terminal via screen to enter passwords or investigate commands

FAQ from Shell and Coding agent for Claude and other mcp clients

What runtime dependencies are required?

Python 3.12, uv (package installer), and optionally screen for terminal attachment. On Windows, WSL is required.

How does the terminal attachment work?

If screen is installed, wcgw runs in a screen session. You can list sessions with screen -ls and attach with screen -x to safely interact with the AI’s terminal.

What modes are available and how do they differ?

Three modes: architect (read-only commands), code-writer (edits/writes allowed only on specified path globs), and wcgw (default, unrestricted). Invoke by saying “Run in [mode] mode”.

What are the known risks or limitations?

The server provides unfiltered shell and file access. It does not restrict the LLM from executing arbitrary commands or making unintended changes. Use only if you fully understand and accept the risks.

Does the server support authentication or encryption?

The README does not mention any authentication or encryption mechanisms. Communication relies on the MCP transport (stdio by default).