Muse Code Remote web terminal

# ⚡ Muse Code Remote (MCR)

> Open-source Web UI & Outbound Terminal Relay for [Meta Muse Code](https://developer.meta.com/ai/products/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

```mermaid
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:

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

### 2. Start the Daemon

```bash
mcr
```

Output:
```text
════════════════════════════════════════════════════════════════════
  ⚡ 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