VERSION 1.0.0 RELEASE OPEN SOURCE • MIT FASTAPI + FLUTTER

CodePilot Remote

by Dream XV • Founded by Sahir Ali

Remote Control for AI Coding Agents. Your AI Workspace. Anywhere.

CodePilot Remote is a provider-agnostic remote control and permission approval gateway designed for terminal-based AI coding agents (Claude Code, Gemini CLI, Aider). Relays sensitive actions (file modifications, shell commands, API queries) instantly to your mobile device for remote review, approval, or denial.

Download Installer & APK Try Live Simulator GitHub Source

SYSTEM ARCHITECTURE

Tri-Tier Real-Time Topology

How CodePilot Remote secures, routes, and executes agent permissions across your desktop workstation, local gateway, and mobile device.

💻

Desktop Agent

Python 3.14+

• Terminal Output Watcher
• Provider Regex Parsers (Claude / Gemini)
• Async WebSocket Client
• Automated Stdin Relay ('y' / 'n')

↔ WS ↔

                        ⚙
                        FastAPI Gateway
                        Uvicorn + aiosqlite
                    
• REST API & WebSockets Routing
• JWT Cryptographic Verification
• 6-Digit Transient Pairing Engine
• Persistent SQLite Audit History

↔ WS ↔

📱

Mobile App

Flutter 3.44

• Real-Time Permission Push UI
• 1-Tap Approve / Deny Actions
• Multi-Session Timeline View
• Risk-Based Notification Rules

PERMISSION LIFECYCLE SEQUENCE

Agent Prompts Permission in stdout

→

Desktop Parser forwards via WebSocket

→

Mobile Companion receives alert

→

User taps Approve / Deny

→

Decision injected into Agent stdin

KEY CAPABILITIES

Engineered for Frictionless AI Supervision

📲 REMOTE APPROVAL

Instant Mobile Decisions

Never stall an AI workflow while away from your keyboard. Review file diffs, terminal commands, and API payloads on your phone and approve with one tap.

🔄 MULTI-SESSION

Concurrent Agent Manager

Create, switch, rename, and supervise multiple active coding sessions (Claude Code, Gemini CLI, Aider) simultaneously from a unified mobile dashboard.

🚀 RECONSTRUCTION

Session State Resume

Closed the terminal or restarted your PC? Reconstruct active sessions from stored metadata seamlessly without losing context or historical state.

📜 SQLITE AUDIT

Persistent Timeline Log

Full offline audit trails stored in lightweight SQLite databases. Review all past file modifications, executions, tests, and security approvals.

🔐 6-DIGIT PAIRING

Transient Cryptography

Link mobile and desktop securely in seconds using 6-digit one-time pairing codes. Signed JWT tokens guarantee authenticated peer-to-peer routing.

⚡ LOW-LATENCY

Real-Time WebSockets

Full-duplex WebSocket channels provide sub-15ms message dispatch and synchronized terminal frame streaming across local LAN or remote proxies.

INTERACTIVE TESTBENCH

Live In-Browser CodePilot Simulator

Experience the complete CodePilot Remote workflow directly in your browser: generate a pairing code, link the companion phone, and approve an AI tool request.

> codepilot start claude

> [FastAPI Gateway] Listening on ws://127.0.0.1:8000

> [Watcher] Claude Code process attached (PID 14208)

> Ready. Click 'Generate Pairing Code' to begin.

CodePilot

🔒

Unpaired Device

Generate a pairing code on your desktop, then enter it here.

_ _ _ _ _ _

CodePilot ONLINE

WORKSTATION BOUND

Sahir-Workstation-01

Active Session: Claude Code (Python API)

Monitoring Agent stdout...

ACTION REQUIRED

⚠ PERMISSION REQUEST

Write File: src/auth.py

Tool: FileEditTool
Lines: +42, -18

COMMAND LINE REFERENCE

Standard CLI Administration

Command	Example	Description
start [provider]	codepilot start claude	Launches background FastAPI gateway and attaches terminal watcher to Claude, Gemini, or generic AI process.
pair	codepilot pair	Generates a cryptographically signed 6-digit transient code to bond a new mobile device.
unpair	codepilot unpair	Revokes active mobile binding mappings in SQLite and cleans local credentials.
status	codepilot status	Pings the local gateway daemon and reports real-time socket connections and session state.

PACKAGES & BINARIES

Download CodePilot Remote

Pre-compiled standalone binaries for Windows workstations and Android mobile devices. No Python installation required to run the standalone executable!

💻 WINDOWS WORKSTATION

CodePilot Standalone Setup

Bundles the Python desktop agent, FastAPI gateway, and runtime dependencies in a standalone executable.

File: CodePilot-Setup.exe Size: ~29.2 MB

Download Windows Setup (.exe)

📱 ANDROID COMPANION

CodePilot Mobile APK

Companion Flutter mobile app to review permission prompts, inspect live output, and control active agent sessions.

File: CodePilot.apk Size: ~54.6 MB

Download Android APK

💻 SOURCE & REPO

GitHub Source Repository

Clone the repository, inspect test suites, contribute providers, or run customized builds on Linux/macOS.

License: MIT Branch: main

View on GitHub

DEFENSIVE ENGINEERING

Security & Hardening by Default

JWT Connection Handshakes

All WebSocket handshakes validate tokens signed with local cryptographic secrets. Unsigned packets are rejected immediately.

SQL Injection Prevention

All database queries are fully parameterized via `aiosqlite` abstractions to eliminate SQL injection vectors.

Automatic Log Redaction

Middleware masks authentication tokens, credentials, and API keys (`token=[REDACTED]`) before emitting log frames.

Sliding Window Rate Limits

Defends against brute-force pairing and replay attacks via nonce tracking within a sliding 5-minute validity window.