⚡ Muse Code Remote (MCR)

Open-source Web UI & Outbound Terminal Relay for Meta Muse Code.

Access your terminal-based Muse Code coding agent securely from any web browser (desktop, tablet, or smartphone) without exposing your machine, forwarding ports, or sharing credentials.

---

🎯 Architecture

flowchart LR
    subgraph ClientMachine["Your Machine / NAS / Server"]
        Daemon["mcr daemon\n(PTY -> muse)"]
    end

    subgraph RelayServer["MCR Relay Server & Web UI"]
        Relay["Relay Bridge\n(Node.js / WebSockets)"]
        WebUI["Web Terminal\n(xterm.js)"]
    end

    subgraph BrowserClient["Browser (Mobile / Desktop)"]
        Browser["User in Browser"]
    end

    Daemon -->|1. Outbound WSS: Registers Token| Relay
    Browser -->|2. Opens Web UI & Enters Token| WebUI
    WebUI -->|3. Pairs via WSS| Relay
    Relay <-->|4. Bidirectional ANSI Stream| Daemon

Key Highlights

• Zero Open Ports / NAT Traversal: The client daemon connects outbound via standard HTTPS/WSS (Port 443). Works behind firewalls, CGNAT, and home routers.
• Pure Bring-Your-Own-Account: Muse Code executes locally on your machine with your own Meta account, API subscription, and permissions (including root/host access if desired).
• Zero Server Overhead: The relay server stores no private code or credentials—it purely mirrors the interactive VT100/ANSI TUI terminal over WebSockets.
• Auto-Resize & Truecolor: Dynamic terminal window adjustments and full 256-color / truecolor support via xterm.js.

---

🚀 Quick Start (Client)

1. Installation

Run the one-line installer on any Linux or macOS machine:

curl -fsSL https://raw.githubusercontent.com/SecretLUL/MuseCodeRemote/main/client/install.sh | bash

2. Start the Daemon

mcr

Output:

════════════════════════════════════════════════════════════════════
  ⚡ Muse Code Remote (MCR) Daemon
════════════════════════════════════════════════════════════════════
  Session Token:   mcr-a7f9-2c4e
  Direct Web Link: https://muse.yourdomain.com/?token=mcr-a7f9-2c4e
  Command:         /usr/local/bin/muse
  Working Dir:     /home/user/myproject
════════════════════════════════════════════════════════════════════
  Waiting for browser connection... (Press Ctrl+C to stop)

Click the direct li