🦁 MobileCoder ZK-Relay Agent

Your Localhost, Everywhere. Securely bridge your mobile device to your desktop IDE (Cursor, VS Code, Terminal) via a Zero-Knowledge Encrypted Relay.

Connect to your dev environment in <200ms with military-grade encryption.

⚡ Why ZK-Relay? Traditional WebRTC connections are often blocked by corporate firewalls, university networks (Eduroam), and strict NATs. Cloud IDEs, on the other hand, require you to upload your code to their servers.

MobileCoder v2 introduces the ZK-Relay Protocol: A custom, lightweight, TCP-based tunneling architecture that ensures 100% connectivity without compromising privacy.

🛡️ Zero-Trust Architecture: Our relay server acts as a "Blind Mailbox". It blindly forwards encrypted packets without ever having the keys to decrypt them.

🔐 End-to-End Encryption: Your data is encrypted locally using AES-256-CBC and only decrypted on your mobile device.

🌍 Universal Bypass: Works behind strict firewalls, VPNs, and 4G/5G networks where P2P fails.

🧠 Context Aware: The agent intelligently detects your environment (VS Code, Cursor, zsh, powershell) and adapts the mobile UI accordingly.

🛠️ Quick Start No complex installation or config files required. Just use npx.

1. Start the Agent (Desktop) Open your terminal (inside VS Code, Cursor, or standalone) and run:

npx mobilecoder-mcp@latest init

This will:

• Generate a cryptographically secure 6-digit pairing code.
• Derive a session key using PBKDF2-SHA256.
• Establish a secure WebSocket tunnel to the Relay Network.

2. Connect (Mobile)

• Open mobilecoder.xyz on your phone.
• Enter the 6-digit code displayed on your terminal.
• Done. You are now connected to your localhost.

🏗️ Architecture & Security We take security seriously. Here is the cryptographic flow of a MobileCoder session:

graph LR
    A[Desktop Agent] -->|AES-256 Encrypted| B(Blind Relay Server)
    B -->|Forwarded Packet| C[Mobile Client]
    
    style A fill:#d4f1f9,stroke:#333,stroke-width:2px
    style B fill:#f9f2f4,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5
    style C fill:#d4f1f9,stroke:#333,stroke-width:2px

🔐 The Crypto Stack

• Key Derivation: The 6-digit OTP is strengthened using PBKDF2 (Password-Based Key Derivation Function 2) with HMAC-SHA256 and 1,000 iterations (synced with mobile for performance & sync).
• Encryption Standard: All data streams are encrypted using AES-256-CBC (Cipher Block Chaining).
• Replay Protection: Each packet includes a unique Nonce (IV) and a timestamp to prevent replay attacks.
• Ephemeral Sessions: No data is ever written to disk. Keys exist only in RAM and are destroyed when the session ends.

📱 Features

• Remote Terminal: Full TTY support with color output and interactive input.
• File Explorer: Browse, read, and manage project files remotely.
• IDE Integration: Automatically detects if you are running inside Cursor or VS Code and adjusts the mobile badge.
• Smart Commands: Run pre-defined scripts (git status, docker ps) with one tap.

🤝 Contributing MobileCoder is built by developers, for developers. We welcome contributions!

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License Distributed under the MIT License. See LICENSE for more information.

Website • GitHub