Summary

kzahel/yepanywhere provides a self-hosted, mobile-first web UI for interacting with AI agents like Claude Code and Codex. It targets developers and power users seeking a superior remote interface, especially from mobile devices, by enabling supervision of agents, seamless integration with existing CLI sessions, and enhanced features without requiring cloud accounts or databases. The primary benefit is a secure, convenient, and feature-rich way to manage AI development workflows remotely.

How It Works

The project leverages a server-side architecture where the web UI runs locally, connecting to existing CLI agent sessions. It avoids introducing a new database by utilizing the persistence mechanisms of the underlying CLI tools. Remote access is secured via end-to-end encryption using SRP-6a and TweetNaCl, facilitated by a free public relay or user-managed infrastructure like Tailscale or Caddy. Notably, it supports server-side rendering for fast mobile performance and integrates WebRTC for streaming and controlling Android devices directly from the web UI.

Quick Start & Requirements

Installation is straightforward via npm: npm i -g yepanywhere. Alternatively, it can be built from source using pnpm. Prerequisites include Node.js and having either the Claude Code or Codex CLI installed and configured. The project provides a free relay for remote access, with configuration options available via CLI (yepanywhere --setup-remote-access ...). Further details on development and configuration can be found in DEVELOPMENT.md.

Highlighted Details

• Mobile-first design with server-side rendering for fast performance.
• End-to-end encrypted remote access via a free relay or self-hosted solutions.
• Seamless interoperation with existing CLI sessions, including viewing and resuming.
• Direct file uploads from mobile devices (screenshots, PDFs, code).
• Push notifications for agent approvals, actionable from the lock screen.
• Remote control of Android emulators and devices over WebRTC.
• Full support for Claude Code and Codex providers, including diffs and approvals.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels such as Discord or Slack.

Licensing & Compatibility

The project is licensed under the permissive MIT license, allowing for commercial use and integration into closed-source projects. It utilizes official SDKs and does not interfere with user authentication mechanisms.

Limitations & Caveats

Functionality is dependent on the user having the respective Claude Code or Codex CLIs installed and operational. Remote device control is currently limited to Android platforms.