Pocketdev

pocketdev

[](https://github.com/Fatihakkul/pocketdev/actions/workflows/ci.yml)

*[Türkçe README](README.tr.md)*

**Develop from your phone.** Claude Code writes code on your Mac; you watch the result live on your phone and drive the whole loop from Telegram — including building the app and installing it on your device.

The interesting half is the second one. Remote chat with an AI is a solved problem. Getting a **real, signed build of your app onto your physical iPhone**, over the internet, with live reload, without paying for EAS Build, TestFlight, ngrok or a VPS — that is what this project actually does.

Job	Usually costs	Here
iOS build	EAS Build credits	local xcodebuild (/localbuild, /otabuild)
Install on a test device	TestFlight / EAS Submit	local .ipa over Tailscale Funnel (/otabuild)
Tunnel / hosting	ngrok Pro, a VPS	Tailscale Funnel, free (cloudflared as fallback)
Driving the work	—	Claude Code over Telegram and a local web panel

Works with **Expo** and **React Native CLI** projects.

**Status:** used daily by its author, verified end to end on real devices, but young. Expect rough edges. macOS + iOS only — see [Scope](#scope).

---

Requirements

• macOS with Xcode and the command line tools
• Node.js 20+
• Claude Code, installed and signed in
• Tailscale — free tier is enough
• CocoaPods — only for React Native CLI projects
• A paid Apple Developer account ($99/yr) — only for /otabuild. /localbuild, /preview and /record work without one.

Setup

git clone https://github.com/Fatihakkul/pocketdev.git
cd pocketdev
npm install
cp .env.example .env

**1. Create a Telegram bot.** Message [@BotFather](https://t.me/BotFather), send `/newbot`, and put the token it gives you into `.env`:

BOT_TOKE