---

What is R2ECO?

R2ECO sits next to your editor and owns the workflow layer — environment setup, terminals, automation, toolchain management, and dev services. It's not an IDE. It's the missing piece that makes "clone → code" actually work.

Core idea: Each project has a devshell.yaml that describes its entire environment. Open the project — R2ECO reads the config and sets up everything automatically.

language: python
setup:
  - install: python@3.12
  - run: pip install -r requirements.txt
services:
  - name: backend
    run: python app.py
    port: 8000
automation:
  on_start:
    - run: echo "Ready to code"

Features

Feature	Description
Dev Environments as Code	devshell.yaml — one file configures your entire project setup
Built-in Terminal	Multi-tab terminal with shell selection and persistent sessions
Monaco Code Editor	Full-featured editor with LSP support, syntax highlighting, GPU-accelerated rendering
File Explorer	Project tree with search, drag & drop, context menus
Git Integration	Stage, commit, push, pull, branch, stash, blame — all built in
Toolchain Manager	Detect and install Python, Node, Rust, Go, .NET and more
Automation Engine	Visual workflow builder with file watchers, triggers, and task runners
Live Server	One-click static file server with auto-reload on port 5500
Debug Adapter Protocol	Integrated debugging with DAP support
AI Assistant	Local AI via Ollama + AI CLI integration (Copilot, Claude, Gemini)
Auto-Updates	Checks GitHub releases, downloads and applies updates seamlessly
Cross-Platform	Windows (CefSharp), Linux & macOS (Photino.NET)

Install

Windows Installer

Download the latest R2ECO-Setup-x.x.x.exe from Releases and run it.

Build from Source

Prerequisites: .NET 9 SDK, Rust toolchain, Node.js 18+

git clone https://github.com/user/R2ECO.git
cd R2ECO

# Build everything
cargo build --release          # Rust engine
cd ui && npm install && npm run build && cd ..  # UI
cd src && dotnet build R2Eco.sln   # .NET host

# Run
cd src && dotnet run --project R2Eco.Host

Or use the build scripts:

# Windows
.\scripts\build.ps1

# Linux/macOS
./scripts/build.sh linux   # or: macos

Build output goes to build/<platform>/.

Architecture

┌─────────────────────────────────────────┐
│            UI (Vite + TypeScript)        │
│  Monaco Editor │ xterm.js │ Vanilla DOM  │
├─────────────────────────────────────────┤
│        JS Bridge (CefSharp / WebSocket)  │
├──────────────────┬──────────────────────┤
│  .NET 9 Host     │    Rust Engine        │
│  Project mgmt    │    Terminal PTY       │
│  Git operations  │    File watching      │
│  LSP/DAP mgmt    │    IPC server         │
│  Live server     │    Search (ripgrep)   │
│  Auto-update     │    Process mgmt       │
└──────────────────┴──────────────────────┘

• UI: Vanilla TypeScript + Vite, Monaco editor, xterm.js — no framework overhead
• .NET 9: Application host, project management, git, LSP/DAP orchestration
• Rust: Performance-critical engine — PTY, file I/O, search, IPC
• CefSharp (Windows) / Photino.NET (Linux/macOS): Native window hosting

Project Structure

R2ECO/
├── ui/                  # Frontend (TypeScript + Vite)
│   └── src/
│       ├── apps/        # App panels (editor, terminal, git, settings...)
│       ├── bridge/      # JS ↔ .NET bridge
│       ├── desktop/     # Window manager, layout, status bar
│       └── services/    # LSP, DAP clients
├── src/                 # .NET backend
│   ├── R2Eco.Core/      # Shared types, IPC client, settings
│   ├── R2Eco.Host/      # Windows host (CefSharp + WinForms)
│   ├── R2Eco.App/       # Cross-platform host (Photino.NET)
│   └── R2Eco.Automation/# Automation engine
├── crates/              # Rust workspace
│   ├── engine/          # Core engine
│   ├── ipc/             # IPC server (named pipes / unix sockets)
│   ├── pty/             # Terminal PTY management
│   └── ...
├── installer/           # Inno Setup installer script
├── scripts/             # Build scripts
└── example/             # Example devshell.yaml projects

Configuration

Settings are stored in %APPDATA%/R2ECO/settings.json (Windows) or ~/.config/R2ECO/settings.json (Linux/macOS).

All settings are editable through the Settings panel (Ctrl+, or sidebar).

License

MIT