Shell and Coding agent for Claude and other mcp clients

Name: Shell and Coding agent for Claude and other mcp clients
Author: rusiaaman

@rusiaaman

代码仓库

关于 Shell and Coding agent for Claude and other mcp clients

Shell and coding agent on mcp clients

#shell #agent #terminal #mcp #openai #claude #ai-agent #llm #chatgpt #anthropic #llm-agent #custom-gpt #claude-desktop #llm-code #ai-coding #mcp-server

基本信息

分类

AI 与智能体

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

rusiaaman

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "wcgw": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "wcgw@latest"
      ]
    }
  }
}

工具

Reset shell and set up workspace environment

Execute shell commands with timeout control

Read content from one or more files

Create new files or write to empty files

Edit existing files using search/replace blocks

Read image files for display/processing

Save project context and files for Knowledge Transfer or saving task checkpoints to be resumed later

概览

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.