Skip to content

✨ A high-performance code agent written in Rust, combining the best features of WCGW for maximum efficiency and semantic capabilities. 🦀

License

Notifications You must be signed in to change notification settings

gabrielmaialva33/winx-code-agent

✨ Winx - High-Performance Rust MCP Server ✨

🚀 1:1 Optimized Rust Implementation of WCGW (What Could Go Wrong) 🚀

Language License MCP

Winx is a specialized Model Context Protocol (MCP) server that provides high-performance tools for LLM code agents. It implements the core functionality of WCGW in pure Rust for maximum efficiency and stability.

⚡ Performance

Benchmarks on i9-13900K + RTX 4090 (WSL2)

Metric Winx (Rust) Python (WCGW) Improvement
Startup Time < 5ms ~200ms 🚀 40x Faster
Shell Command Latency < 1ms ~15ms 🚀 15x Lower
File Read (1MB) 0.4ms ~40ms 🚀 100x Faster
Memory Footprint ~5MB ~65MB 📉 13x Smaller

Benchmarks performed using hyperfine and memory profiling tools on standard workloads.

🛠️ MCP Tools

Tool Description
Initialize Required. Setup workspace environment and shell mode options (Restricted/Full).
BashCommand Execute shell commands with full PTY support (interactive, stateful).
ReadFiles Efficient zero-copy file reading with line-range support.
FileWriteOrEdit Robust file modification using exact SEARCH/REPLACE blocks.
ContextSave Snapshot current project context (files + description) for resumption.
ReadImage Optimized base64 image reading for multimodal agent contexts.

🚀 Quick Start

Prerequisites

  • Rust 1.75+
  • Linux / macOS / WSL2

Installation

git clone https://github.com/gabrielmaialva33/winx-code-agent.git
cd winx-code-agent
cargo build --release

Integration with Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "winx": {
      "command": "/path/to/winx-code-agent/target/release/winx-code-agent",
      "args": ["serve"],
      "env": { "RUST_LOG": "info" }
    }
  }
}

🏗️ Architecture

  • PTY Shell: Full pseudo-terminal support for interactive commands.
  • Zero-Copy I/O: Uses memory-mapped files for blazing fast reads.
  • Strict Typing: Powered by Rust's safety and performance guarantees.
  • WCGW Parity: Designed to be a drop-in replacement for Python-based toolsets.

📜 License

MIT - Gabriel Maia (@gabrielmaialva33)

✨ Optimized for the next generation of AI Agents ✨

About

✨ A high-performance code agent written in Rust, combining the best features of WCGW for maximum efficiency and semantic capabilities. 🦀

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •