This project provides a shell and coding agent for Claude and other MCP clients, enabling chat applications to code, build, and run locally. It targets developers and power users seeking to integrate LLM-driven code execution and manipulation directly into their workflows, offering enhanced productivity and automation for complex coding tasks.

How It Works

The agent functions as an MCP server, tightly integrating shell and code editing tools. It employs an Aider-like search-and-replace mechanism for file edits, offering spacing-tolerant matching and returning the closest match for AI correction. Shell commands are managed with a single instance, returning the current working directory after each execution and using quick timeouts for command polling with wait tolerance for output streaming. File operations include protections like requiring a file to be read before editing and chunking large files to manage token limits.

Quick Start & Requirements

• Installation: Configure claude_desktop_config.json with the provided JSON snippet, pointing to uv tool run --python 3.12 wcgw@latest. Restart the Claude app.
• Prerequisites: macOS or Linux. uv must be installed globally (e.g., via Homebrew on macOS). For Windows, WSL is required.
• Setup Time: Minimal, primarily configuration file updates.
• Documentation: https://github.com/rusiaaman/wcgw

Highlighted Details

• Supports large file incremental edits, intelligently choosing between small edits or large rewrites.
• Provides syntax checking on edits, feeding feedback to the LLM for correction.
• Enables interactive command handling with support for arrow keys, interrupts, and ANSI escape sequences.
• Offers modes like 'architect' for planning and 'code-writer' for development, with a default unrestricted 'wcgw' mode.

Maintenance & Community

The project is actively updated, with recent changes focusing on terminal attachment, context saving, and syntax checking. There is an optional VS Code extension available.

Licensing & Compatibility

The repository does not explicitly state a license in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project warns against allowing the BashCommand tool without reviewing commands due to potential data loss. In 'code-writer' mode, command restrictions are currently not strictly enforced at the execution level. The README mentions that uv version 0.6.0 was used for testing.