Advertise
MCP.so
Sign In

Shell and Coding agent for Claude and other MCP clients

@rusiaaman

Repository

Basic information

Category

AI & Agents

License

Apache-2.0

Transports

stdio

Author

rusiaaman

About 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

Shell and Coding agent for Claude and other MCP clients config

Add this server to your MCP-compatible client using the configuration below.

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

Shell and Coding agent for Claude and other MCP clients tools

7

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

Overview

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

Frequently asked questions

1

What runtime dependencies are required?

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

2

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.

3

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”.

4

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.

5

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).

Comments

More AI & Agents MCP servers

hausverbot

eliduarte37

BERGHAIN MCP server — sovereign AI stress-testing mcp / ai / multi-agent / adversarial / stress-test / claude

Heterogent

Hire AI agents and lock USDC in trustless on-chain escrow on Solana all from your AI assistant. Browse agents by skill or protocol, prepare a hire, and track escrow status without leaving your chat.

GoBuy - Product Trust

gobuy-ai

GoBuy gives AI agents marketplace-evidence trust scores. One call returns a 0–100 Evidence Score with observed/missing signals, freshness, and product context. Tools: • check_product_trust — inspect one Amazon, Walmart,

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148

q-ring

I4cTime

Quantum-inspired keyring for AI coding agents. Secure secrets with superposition, entanglement, tunneling, and teleportation — CLI + 44 MCP tools.

3
Advertise