drio
Open app

Shell and Coding agent for Claude and other mcp clients

Source

Shell and coding agent on claude desktop app

Catalog onlyCatalog onlySTDIO

Overview

wcgw is a shell and coding agent designed for the Claude desktop app and ChatGPT, enabling autonomous shell command execution and coding tasks through interactive commands.

To use wcgw, install the necessary components, configure the Claude desktop settings, and start issuing commands or coding tasks through the app. Detailed instructions are available in the setup documentation.

  • Full Shell Access for command execution. - Desktop control on the Claude app for screen capture and input controls. - REPL support for languages like Python and Node. - Interactive Command Handling with support for arrows and ANSI escape sequences. - Ability to create, execute, and iterate coding tasks.
  1. Automating code writing and debugging in temporary directories.
  2. Managing large file edits without hitting token limits.
  3. Running commands in background while managing multiple processes.
  4. Creating feature branches and managing pull requests using Git CLI.
  5. Running applications in docker containers and controlling their environments.

Add to your AI client

Use these steps to connect Shell and Coding agent for Claude and other mcp clients in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "wcgw-rusiaaman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "wcgw-rusiaaman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "wcgw-rusiaaman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "wcgw-rusiaaman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wcgw-rusiaaman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "wcgw-rusiaaman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wcgw-rusiaaman"
      ]
    }
  }
}

FAQ

**Can wcgw run commands on any OS?**

wcgw is currently optimized for mac and Linux usage in desktop environments.

**Is there a risk with autonomous shell execution?**

Yes, it's essential to understand the risks of executing shell commands autonomously; ensure you understand commands before running them.

**Is there support for IDE integration?**

Yes, there is an optional VS Code extension for seamless integration with the wcgw environment.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":469,"uuid":"f30f77ee-b7fb-4afe-af05-fa9d372a0bed","name":"wcgw","title":"Shell and Coding agent for Claude and other mcp clients","description":"Shell and coding agent on claude desktop app","avatar_url":"https://avatars.githubusercontent.com/u/34934104?v=4","created_at":"2024-12-19T02:13:41.307Z","updated_at":"2024-12-19T12:38:32.605Z","status":"created","author_name":"rusiaaman","author_avatar_url":"https://avatars.githubusercontent.com/u/34934104?v=4","tags":"shell,agent,terminal,mcp,openai,claude,ai-agent,llm,chatgpt,anthropic,llm-agent,custom-gpt,claude-desktop,llm-code,ai-coding,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/rusiaaman/wcgw","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/rusiaaman/wcgw/actions/workflows/python-tests.yml/badge.svg?branch=main","type":null,"metadata":"{\"star\":\"492\",\"license\":\"Apache-2.0 license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-06-04 17:59:07\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools