🪄 Winx
The High-Performance, Remote-First MCP Runtime for AI Coding Agents
Durable PTY Sessions • Streamable HTTP • Guarded File Operations • Blazing Fast Rust 🦀
"Give remote and local LLMs durable, authenticated hands on your development machine."
⚡ Quickstart • ✨ Features • 🏗️ Architecture • 🌐 HTTP Guide • 🛡️ Security
English • Português • 中文
Winx is a remote-first MCP runtime for agents that need a real shell, guarded file-editing primitives, repository-aware code navigation, and sessions that survive dropped connections. Its primary deployment path is a hardened Streamable HTTP endpoint for ChatGPT and other cloud or networked MCP clients; stdio remains fully supported for Claude Code, Codex CLI, Cursor, VS Code, and other local clients.
On Linux, macOS, and native Windows, Winx separates the MCP adapter from the processes that own each PTY. winxd
manages the control plane and one winx-guardian per logical session keeps the shell alive across HTTP disconnects,
client restarts, and adapter upgrades (Unix-domain sockets on Unix, named pipes plus job objects on Windows).
It started as a Rust port of WCGW, but it is not a Python wrapper: cd persists,
Ctrl+C interrupts the real process, interactive TUIs work, and large terminal output is rendered and token-budgeted
before reaching the model.
