CodeMote

Product Introduction

1. Definition: CodeMote is a mobile-first remote development and AI agent control platform. Technically, it is a client-server application that establishes a secure, direct tunnel between an iOS/iPadOS device and a developer's local machine or remote server (VPS), providing a full-featured remote terminal, file browser, Git client, and live activity stream to the iPhone's Lock Screen.
2. Core Value Proposition: It exists to unchain developers from their desks by providing a secure, native mobile interface to their entire development environment. Its primary value is enabling continuous workflow with AI coding agents (like Claude Code or Codex) and core development tasks from anywhere, without ever copying source code to a third-party cloud server.

Main Features

1. Lock Screen Live Activity & Terminal Stream: This feature renders a live, updating terminal session directly on the iPhone's Lock Screen via a persistent Live Activity. It dynamically switches to a "waiting for input" state when an AI agent requires approval, sending a push notification. This allows for glanceable oversight and quick decision-making without unlocking the phone.
2. Direct, Encrypted Machine-to-Phone Tunnel: CodeMote establishes a peer-to-peer connection using Microsoft's free devtunnel CLI (with optional ngrok or Tailscale Funnel support). This creates an outbound-only, encrypted tunnel from the host machine to the phone. Critically, CodeMote's servers only facilitate the initial handshake; all subsequent data (code, terminal I/O, file contents) flows directly, never persisting on CodeMote's infrastructure.
3. Full-Stack Development Environment on Mobile: Beyond a simple terminal, the app provides integrated, native mobile interfaces for: a real terminal with full TTY support; a Git client capable of staging, committing, pushing, branching, and viewing history; a file browser and editor for navigating the project tree and editing code; and the ability to view precise diffs in a dedicated viewer, not just chat output.
4. Editor-Agnostic & Headless-Compatible Connectivity: CodeMote offers two connection methods: a VS Code extension for editors like VS Code, Cursor, and Antigravity, and a standalone Node.js CLI (npx codemote-cli). The CLI enables use on headless servers, VPS instances, Raspberry Pis, or any machine without a graphical editor, requiring only Node.js 18+.

Problems Solved

1. Pain Point: The disruption caused when an AI coding agent running a long task (e.g., a refactor) halts for approval while the developer is away from their computer. Traditional mobile apps for these agents are cloud-based chat interfaces that lack context, real diffs, and direct machine access.
2. Target Audience: Software engineers and developers who utilize AI coding assistants (Claude Code, Codex, Cursor's agent) in their workflow. Specifically, those who value deep integration with their local toolchain, require high security for proprietary code, and seek to maintain productivity during commutes, travel, or outside of core desk hours.
3. Use Cases: 1) Unblocking AI Agent Runs Remotely: Starting a complex agent task at your desk, leaving, and approving/redirecting the next steps from your phone. 2) Emergency Production Fixes: Diagnosing and patching a live site issue from a mobile device by accessing the repository, terminal, and deployment scripts directly. 3) Mobile Code Review: Reviewing pull requests or examining changes by browsing the actual codebase and reading full diffs from a phone or tablet.

Unique Advantages

1. Differentiation: Unlike official mobile apps from Claude or Cursor which are locked to their specific cloud-based chat agents, CodeMote is agent-agnostic and provides direct machine control. It offers a real terminal, full Git operations, file editing, and dev server management—capabilities absent in competitor chat-only interfaces. Unlike traditional remote desktop solutions, it is optimized for development workflows and Lock Screen interaction.
2. Key Innovation: The integration of a live, interactive terminal session into the iPhone's Lock Screen via Live Activities transforms passive notifications into an active control panel. This, combined with a security model that ensures zero code persistence on its servers and zero credentials stored on the mobile device (using revocable, QR-code-paired tokens), creates a uniquely seamless and secure mobile development experience.

Frequently Asked Questions (FAQ)

1. Does CodeMote upload my source code to its servers? No. CodeMote facilitates a direct, encrypted connection between your iPhone and your development machine. Your code, terminal data, and file system access never touch or are stored on CodeMote's servers; the connection is tunneled peer-to-peer using Microsoft DevTunnel, ngrok, or Tailscale.
2. Can I use CodeMote with AI agents like Claude Code on a headless server? Yes. Using the standalone CodeMote CLI (npx codemote-cli start), you can install and run CodeMote on any headless server, VPS, or machine with Node.js. You can then start Claude Code or any CLI-based AI agent in a terminal and control it fully from the CodeMote iPhone app.
3. How does CodeMote's security model work for pairing and access? Pairing is done locally via a QR code or one-time pairing string generated on your host machine. This establishes a secure, revocable token. You maintain control and can instantly revoke access from either the host machine (via editor command/CLI) or the mobile app, severing the connection.
4. What editors and AI agents are compatible with CodeMote? CodeMote is compatible with any editor that supports VS Code extensions, including VS Code, Cursor, Antigravity, and Windsurf. It supports any AI coding agent that can be run from a command line interface (CLI), such as Claude Code, Codex, or custom scripts, as it provides a full, real terminal session.
5. Is an internet connection required, and do I need to open ports on my router? An internet connection is required to establish the initial tunnel. However, you do not need to manually open ports or configure SSH/VPN. CodeMote uses outbound tunneling technologies (like DevTunnel) that work behind firewalls without requiring inbound port forwarding.