A better remote interface for Claude Code and Codex. Self-hosted, no cloud accounts. Supervise your agents from your phone while they run on your dev machines.

Features

• Interop — View and resume sessions started in CLI, VS Code, or other tools. No new database — piggybacks on CLI persistence
• File uploads — Share screenshots, photos, PDFs, and code files directly from your phone's camera roll
• Push notifications — Get alerted when approval is needed, respond from your lock screen
• E2E encrypted remote access — Connect from anywhere via our free relay. We can't see your data (SRP-6a + TweetNaCl)
• Fork/clone conversations — Branch from any message point to explore alternatives
• Tiered inbox — Needs Attention → Active → Recent → Unread. Stop cycling through terminal tabs
• Global activity stream — See what all your agents are doing across sessions
• Remote device control — Stream Android emulators and devices to your phone over WebRTC. Touch input, nav buttons, adaptive quality
• Server-owned processes — Client disconnects don't interrupt work
• Voice input — Talk to your agents via browser speech API
• Fast on mobile — Syntax highlighting and markdown rendering happen server-side

No database, no cloud, no accounts. 100% open source (MIT).

Supported Providers

| Provider | Diffs | Approvals | Streaming | Notes | |----------|-------|-----------|-----------|-------| | Claude Code | Full | Yes | Yes | Primary provider, full feature support | | Codex | Full | Yes | Yes | Full support including diffs and approvals |

Screenshots

Works great on desktop too!

Getting Started

If you can install Claude Code or Codex, you can install this. Minimal dependencies.

npm i -g yepanywhere
yepanywhere

Or, from source:

git clone https://github.com/kzahel/yepanywhere.git
cd yepanywhere
pnpm install
pnpm build
pnpm start

Open http://localhost:3400 in your browser. The app auto-detects installed CLI agents.

Updating

For the npm-global install:

npm update -g yepanywhere

Then restart yepanywhere.

For a source checkout:

git fetch origin
git merge origin/main
pnpm install
pnpm build

Then restart the server with pnpm start.

Voice Input and STT Keys

Browser-native voice input works without extra configuration. To use server-mediated STT, export the provider key in the Yep Anywhere server environment before starting the app:

export YA_stt__XAI_API_KEY="xai-..."
export YA_stt__DEEPGRAM_API_KEY="deepgram-..."

Providing YA_stt__XAI_API_KEY auto-enables the ya-grok backend; providing YA_stt__DEEPGRAM_API_KEY auto-enables the ya-deepgram backend. These YA_<module>__<NAME> secrets are consumed by Yep Anywhere and stripped from child agent environments. The STT-specific xAI key is preferred over a general XAI_API_KEY, which lets speech transcription use different billing from any Grok model or CLI usage.

If you already exported xAI's standard XAI_API_KEY, Yep Anywhere will also use it for Grok STT and scrub it from child agent environments. Grok Build does not receive XAI_API_KEY by default, avoiding accidental pay-as-you-go provider billing; Settings > Providers has an explicit opt-in to pass that key to Grok Build. For backend behavior and retention details, see the server-mediated STT topic; for the broader environment variable table, see topics/ya-env-vars.md.

Remote Access

Easiest: Use our free public relay when you want passworded, end-to-end encrypted access from any browser. Configure it in Settings, or via CLI for headless setups:

yepanywhere --setup-remote-access --username myserver --password "secretpass123"

Then connect from anywhere at yepanywhere.com/remote.

All traffic is end-to-end encrypted and we can't see your data. No accounts required.

Private network: If you only need to reach a solo install from your phone, a VPN such as Tailscale is usually simpler than deploying your own relay: put the phone and dev machine on the same private network, then open the Yep Anywhere server from the phone.

Self-hosted web access: Prefer to run your own public infrastructure? Use Caddy or any reverse proxy with SSL termination. See the remote access docs for details.

Why not just use the terminal?

You can use the terminal on your phone — but monospace text is painful on a small screen, there's no file upload, no push notifications, and no way to see all your sessions at once. This gives you a proper UI while keeping everything self-hosted and running your code locally.

Comparison to Other Tools

There are a lot of projects in this space. We track them all: docs/competitive/all-projects.md

Development

See DEVELOPMENT.md for build instructions, configuration options, and more. For client render/update architecture and performance invariants, see packages/client/RENDERING_PERFORMANCE.md.

TOS Compliance

Yep Anywhere uses the official @anthropic-ai/claude-agent-sdk published by Anthropic. We don't handle authentication, spoof headers, or manipulate OAuth tokens. You authenticate via your own Claude CLI — we're just a remote interface to your sessions.

Read more: How we use the SDK | Feb 2026 auth clarification

Star History

License

MIT