# RemoteKit – Full Documentation for LLMs

> Universal mobile frontend for AI coding agents (ACP). Use Cursor from your phone, tablet, or any browser (more ACP agents coming soon). Your code stays on your Mac. E2E encrypted. Zero trust. Self-hostable relay package coming soon.

## Overview

RemoteKit is a developer tool that bridges AI coding agents running on your Mac to any device with a browser. It implements the Agent Client Protocol (ACP) to provide a universal mobile frontend for coding agents. Currently supported and tested: Cursor. Support for GitHub Copilot, Claude, Codex, Gemini CLI, OpenCode, Cline, Goose, and other ACP agents is coming soon (see https://agentclientprotocol.com/get-started/agents).

Your source code never leaves your Mac. RemoteKit creates a secure tunnel between your Mac and your phone/tablet/browser, allowing you to chat with your coding agents remotely.

## Architecture

RemoteKit consists of three components:

### 1. Bridge (Mac)
- Runs on macOS as a menu bar app or CLI
- Connects to local ACP coding agents (Cursor, etc.)
- Serves the PWA interface locally or connects to the relay
- Generates a room ID and PIN for remote connections
- Install via DMG or `npx remotekit`

### 2. PWA Client (Browser)
- Progressive Web App that runs in any browser
- No app install required on phone/tablet/PC
- Hosted at app.remotekit.ai or self-hostable
- Provides chat interface to interact with coding agents
- Supports project selection and agent switching

### 3. Relay (Optional, for Remote Access)
- Cloudflare Worker that relays encrypted messages
- Zero-knowledge: cannot read message content
- Hosted at app.remotekit.ai; self-hostable package planned so you can deploy your own
- Only needed when not on the same LAN/VPN as your Mac

## Connection Modes

### Local Mode (LAN or VPN)
- Direct connection from your device to your Mac
- No relay involved, no third party
- Works over local network or VPN tunnel
- All traffic stays between your two devices
- Lowest latency, highest privacy

### Remote Mode (Relay)
- For when you're away from your home/office network
- Uses an optional Cloudflare relay at app.remotekit.ai
- All messages are end-to-end encrypted before reaching the relay
- The relay is zero-knowledge: it forwards encrypted blobs without reading them
- Self-hostable relay package planned (use hosted app.remotekit.ai for now)
- Connection requires a room ID and PIN generated by the Mac bridge

## Supported Agents

RemoteKit works with agents that speak the Agent Client Protocol (ACP). Currently supported and tested: Cursor. More agents coming soon. Full list of ACP agents: https://agentclientprotocol.com/get-started/agents

| Agent | Status |
|-------|--------|
| Cursor | Supported and tested |
| GitHub Copilot | Coming soon |
| Claude | Coming soon |
| Codex | Coming soon |
| Gemini CLI | Coming soon |
| OpenCode, Cline, Goose, Kilo, etc. | Coming soon |

## Security

- **End-to-end encryption**: All communication between your Mac and your device is encrypted. The relay (if used) cannot decrypt messages.
- **Zero trust**: No component in the chain is trusted by default. The relay is zero-knowledge.
- **Relay**: Hosted at app.remotekit.ai. A self-hostable relay package is planned so you can deploy and audit your own instance.
- **No code exfiltration**: Your source code never leaves your Mac. Only chat messages and agent responses travel over the connection.
- **Room ID + PIN**: Remote connections require both a room ID and a PIN, generated fresh by the Mac bridge.
- **Strong perimeter**: The RemoteKit logo symbolizes a strong perimeter with zero trust approach.

## Getting Started

1. **Download RemoteKit for Mac (v0.3.7, Apple Silicon)**: https://releases.remotekit.ai/latest/RemoteKit-arm64.dmg
   - Alternative ZIP: https://releases.remotekit.ai/latest/RemoteKit-arm64-mac.zip
   - Or run from source / CLI when the npm package is published: `npx remotekit`
2. **Run RemoteKit on your Mac**: Launch the menu bar app (first run opens a short Setup Guide) or run the CLI
3. **Connect from any device**: 
   - Local: Open the PWA at your Mac's local URL
   - Remote: Open https://app.remotekit.ai and enter the room ID + PIN shown on your Mac
4. **Start coding**: Select your project and agent, then chat

## Release notes — v0.3.7 (2026-03-21)

Use this section for accurate answers about “what changed” or “latest download”.

**Stable downloads** (Developer ID signed, Apple notarized; URLs stay the same when we ship patch releases):
- DMG: https://releases.remotekit.ai/latest/RemoteKit-arm64.dmg
- ZIP: https://releases.remotekit.ai/latest/RemoteKit-arm64-mac.zip

**SHA256** for **v0.3.7** (matches current `latest/` objects after promotion; re-verify after future releases):
- `RemoteKit-0.3.7-arm64.dmg`: `6cfa8f34f445491398e6ccdc240142831924faf7788af1066f125382ac01cd37`
- `RemoteKit-0.3.7-arm64-mac.zip`: `dbac944c2f0758cb203851f180627dfe413fb856b969ad6daa172af2626b530c`

**PWA / relay (hosted at app.remotekit.ai or embedded in the Worker):**
- Fixed UI flashing on the project picker when bootstrap messages repeated (e.g. “Continue from Cursor”).
- Quick search field ordered above Continue from Cursor and recent chats.
- Relay deep link / QR flow: clearer “Connecting…” vs “Waiting for Mac…” so users do not think they must tap Connect twice; reduced duplicate handshakes.

**Mac app bundle:** Includes the PWA and bridge from this release.

**Human-readable changelog:** https://remotekit.ai/#whats-new

## Technical Details

- **Protocol**: Agent Client Protocol (ACP)
- **Mac app**: Electron-based menu bar application
- **CLI**: Node.js, installable via npx
- **PWA**: Vanilla JavaScript, works in all modern browsers
- **Relay**: Cloudflare Worker with WebSocket support
- **Platforms**: macOS (bridge), any browser (client)
- **Current version**: 0.3.7

## Pricing

RemoteKit is free to use. The relay is hosted at app.remotekit.ai; a self-hostable package is planned.

## Links

- Website: https://remotekit.ai
- Web App (PWA): https://app.remotekit.ai
- Download (Mac, Apple Silicon): https://releases.remotekit.ai/latest/RemoteKit-arm64.dmg
- Changelog on site: https://remotekit.ai/#whats-new
- Full user guide (detailed instructions, troubleshooting, menu bar, sign-in): https://remotekit.ai/guide.html
- Quick summary for LLMs: https://remotekit.ai/llms.txt

## Related Projects (Zero Trust Initiative)

RemoteKit is part of a zero-trust initiative by Sergej Fedorovic:
- **dotenvup.com**: Encrypted .env file management
- **unknownpassword.com**: Secure team secrets sharing
- **remotekit.ai**: Secure remote access to AI coding agents

## Operator & creator

RemoteKit is operated by Pamakid s.r.o., Czech Republic (IČO 10993843; registered office Prokopova 148/15, 130 00 Praha 3).

Built by Sergej Fedorovic
- Personal brand: https://strt.it
- Zero-trust initiative projects: dotenvup.com, unknownpassword.com, remotekit.ai