Awesome AI Agents › Smart Contract Platforms

rusiaaman/wcgw

⭐ 674 Python added to this list on 2025-03-09 repository created 2024-09-20

The project "wcgw" by rusiaaman is a shell and coding agent designed to integrate with Claude and ChatGPT desktop applications, enabling these chat-based AI models to code, build, and execute commands on a local machine. It provides a tightly integrated environment where Claude operates as an MCP server with shell and code editing tools, while ChatGPT can communicate with the shell through a relay server, supporting Linux, macOS, and Windows (via WSL). The project emphasizes safety by warning users to review commands before execution to prevent data loss. Key features include the ability to create, execute, and iterate code with continuous compiler checks until errors are resolved, support for editing large files incrementally to avoid token limits, and syntax checking on edits to ensure code correctness. The shell interaction is optimized to allow only one command at a time, maintaining a single shell instance and returning the current working directory after commands to keep the AI context accurate. Interactive command handling supports arrow keys, interrupts, and ANSI escape sequences. File protections are robust, requiring the AI to read a file before editing to prevent accidental overwrites, chunking large files to manage context size, and using intelligent search-replace methods for accurate edits. The project also supports saving repository context in a single file for task checkpointing and knowledge transfer, enabling resumption of tasks in new chats. Users can switch between modes such as architect (for planning), code-writer (for coding and building), and a full-authority wcgw mode. The system runs in a multiplex terminal allowing users to attach to the AI's terminal session to view history or interact directly. The project includes detailed setup instructions for Mac, Linux, and Windows (WSL) environments, and offers a VSCode extension for pasting context into the Claude app. Use cases range from solving coding problems, managing repositories, building web apps, running tests, fixing issues, to managing multiple background processes. Overall, wcgw enhances AI-assisted coding workflows by tightly integrating shell command execution and code editing within chat applications, providing a powerful tool for developers to automate and interact with their local development environment through AI.

https://github.com/rusiaaman/wcgw

agentai-agentai-assisted-codingai-codinganthropicchatgptclaudeclaude-desktopcode-editingcoding-agentcompiler-checkscustom-gptdevelopment-environmentfile-protectionsinteractive-commandslarge-file-editlinuxllmllm-agentllm-codelocal-machinemacosmcpmcp-servermultiplex-terminalopenairelay-servershellsyntax-checkingtask-checkpointingterminalvscode-extensionwindowswsl