wcgw

Overview

Wcgw is a comprehensive MCP server that tightly integrates shell and code editing tools, enabling AI agents to interact directly with your local machine. It provides unfiltered access to the shell and file system with built-in safety features like file protection and syntax checking. The server supports interactive commands, concurrent background processes, and includes a VSCode extension for an enhanced terminal experience.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• InitializeInitialize(any_workspace_path: string, initial_files_to_read: string[], mode_name: 'wcgw'|'architect'|'code_writer', task_id_to_resume: string)

  Reset shell and set up workspace environment

  Try:Initialize my project directoryTry:Start in architect modeTry:Resume task xyz123
• BashCommandBashCommand(command: string, wait_for_seconds: int?), BashCommand(send_text: string, wait_for_seconds: int?), BashCommand(send_specials: string[], wait_for_seconds: int?)

  Execute shell commands with timeout control or send input to interactive commands

  Try:Run 'npm install'Try:Send 'yes' to confirmTry:Press Ctrl+C to interrupt
• ReadFilesReadFiles(file_paths: string[])

  Read content from one or more files

  Try:Read package.json and README.mdTry:Show me the src/index.js file
• WriteIfEmptyWriteIfEmpty(file_path: string, file_content: string)

  Create new files or write to empty files

  Try:Create a new requirements.txt fileTry:Write a basic README to an empty file
• FileEditFileEdit(file_path: string, file_edit_using_search_replace_blocks: string)

  Edit existing files using search/replace blocks

  Try:Fix the import statement in utils.jsTry:Replace the old API endpoint with the new one
• ReadImageReadImage()

  Read image files for display/purpose

  Try:Show me the logo.png fileTry:Display the chart from data visualization

Comparable tools

Installation

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

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

FAQ

Is this tool safe to use?

The tool provides unfiltered access to your machine's shell and files. It does not restrict LLMs from executing arbitrary commands. Only use it if you fully understand and accept the associated risks.

How can I monitor the terminal activity?

You can use the VSCode extension or run `screen -x <wcgw_session_name>` to attach to the terminal that the AI is using, allowing you to monitor or interact with the running commands.

On Hacker News

Recent discussion from the developer community.

• Claude desktop shell agent using Model Context Protocol▲ 3💬 1
  Story by pcwelder · 2024-11-26
• Computer use on Claude desktop app using model context protocol▲ 1💬 1
  Story by pcwelder · 2024-11-26
• Show HN: Custom GPT allows full shell interaction on chatgpt.com▲ 1
  Story by pcwelder · 2024-10-22

Compare wcgw with