Skip to content

README.md

Latest commit

 

History

History
267 lines (188 loc) · 10.5 KB

README.md

File metadata and controls

267 lines (188 loc) · 10.5 KB

MobileFlow

MobileFlow

Control Claude Code, OpenAI Codex, Aider, Gemini CLI, GitHub Copilot and other AI coding agents from your phone.

MobileFlow is an open-source mobile remote coding client. It lets you chat with AI coding agents, browse files, run terminal commands, preview local web apps, and manage Git from your phone.

Your computer runs the coding tools. Your phone becomes the remote control.

Release Downloads Stars License

⬇️ Download  •   🚀 Quick Start  •   🤖 Supported Tools  •   📡 Connection Modes  •   ❓ FAQ  •   🇨🇳 中文

Why MobileFlow?

You're on the couch, in bed, or on the bus — and you want to check your code, ask AI a question, or push a quick fix. You don't want to open your laptop.

MobileFlow turns your phone into a remote control for your desktop AI coding tools. Your code never leaves your computer. The phone is just the screen.

Screenshots

AI Chat Light Theme File Browser Terminal
Git History Git Detail Settings File Editor

Supported AI Coding Tools

Tool Status Description
Claude Code ✅ Supported Anthropic's AI coding agent
OpenAI Codex ✅ Supported OpenAI's coding CLI
Aider ✅ Supported Open-source AI pair programming
Gemini CLI ✅ Supported Google's AI coding tool (free tier)
GitHub Copilot ✅ Supported GitHub's AI assistant
Kiro CLI ✅ Supported AWS's AI coding agent
Local terminal tools ✅ Supported Any CLI tool on your computer
Cline 🔜 Planned VS Code AI extension

All tools communicate via ACP (Agent Client Protocol).

✨ What You Can Do

Use Claude Code from your phone

Chat with Claude Code running on your desktop. Send coding tasks, review changes, and approve file edits — all from your phone screen.

Use OpenAI Codex from your phone

Control OpenAI Codex CLI remotely. Submit prompts, watch code generation, and manage your coding sessions on the go.

Use Aider from your phone

Run Aider pair programming sessions from your phone. Add files to context, send instructions, and review AI-generated commits.

Run terminal commands from your phone

Full terminal access with PTY support. Run builds, install packages, check logs, and Ctrl+C to cancel — just like sitting at your desk.

Manage Git from your phone

View diffs, stage changes, commit, push, pull, switch branches, and browse commit history. Multi-repo support included.

Preview local web apps on mobile

See your web app running on your desktop rendered on your phone screen. Test responsive layouts without deploying.

All features at a glance

  • 🤖 Chat with AI — Claude Code, Codex, Gemini CLI, Kiro, GitHub Copilot, Aider, and more
  • 📁 Browse & edit files — syntax highlighting for 100+ languages, search
  • 💻 Full terminal — run commands, see output, Ctrl+C to cancel
  • 🔀 Git everything — diff, stage, commit, push, pull, switch branches, multi-repo
  • 🖥️ Live preview — see your web app running on desktop, right on your phone
  • ⚡ Run configs — launch, stop, and monitor dev servers remotely
  • 🔌 Slash commands — CLI-advertised commands (/review, /compact) in chat menu
  • 🔒 End-to-end encrypted — AES-256 / NaCl SecretBox, your code stays on your machine
  • 📡 Works anywhere — same WiFi, remote relay, or self-hosted tunnel
  • 🔄 Session resume — reconnect without losing AI conversation context

🚀 Quick Start

3 steps, 2 minutes.

① Install Agent on your computer

Download from Releases → run it → a tray icon appears with your IP and password.

Platform File
Windows mobileflow-agent-windows.exe
macOS mobileflow-agent-macos
Linux mobileflow-agent-linux

Or run from source:

cd agent && pip install -e . && python -m mobileflow_agent

② Install App on your phone

Download the APK from Releases → install → enter IP, port 9600, and password.

③ Install an AI tool

npm i -g @anthropic-ai/claude-code    # or any AI CLI you prefer
npm i -g @openai/codex                # OpenAI Codex
npm i -g @google/gemini-cli           # Gemini CLI (free tier)
pip install aider-chat                # Aider

That's it. Open the app, start chatting.

🏗️ How It Works

  📱 Phone                          💻 Computer
┌────────────┐   encrypted WS    ┌────────────────┐
│ Flutter    │◄──────────────────►│ Python Agent   │
│            │                    │                │
│ Chat UI    │                    │ AI CLI (ACP)   │
│ Files      │                    │ File System    │
│ Terminal   │                    │ Terminal PTY   │
│ Git        │                    │ Git            │
│ Preview    │                    │ Dev Server     │
└────────────┘                    └────────────────┘

The phone app is a thin UI layer — zero data storage. The Agent runs on your desktop, managing AI tools, files, and terminal sessions. All communication is encrypted via ACP (Agent Client Protocol).

🔐 Security
🔑 AES-256 / NaCl encryption Every message encrypted, even on LAN
🚫 Zero third-party servers Direct connection, your code never leaves your machine
🛡️ Brute-force protection 3 failed attempts → 60s lockout
🎫 Session tokens Password only used once during pairing
🔒 Tunnel mode TLS + Bearer Token authentication

📡 Connection Modes

Mode When to use Security Latency
LAN Same WiFi AES-256 after pairing < 10ms
Relay Different networks E2E NaCl SecretBox ~50-100ms
Tunnel Self-hosted WSS TLS + Bearer Token Depends

📖 Not on the same WiFi? See the Remote Connection Guide for relay and tunnel setup.

🛠️ Development

# Agent (Python 3.10+)
cd agent
pip install -e ".[dev]"
pytest

# App (Flutter 3.3+)
cd app
flutter pub get
flutter test
flutter run

FAQ

Can I use Claude Code from my phone?

Yes. MobileFlow lets you control Claude Code running on your computer from your phone. You get full chat, file browsing, and terminal access.

Can I use OpenAI Codex from mobile?

Yes. MobileFlow supports remote control for OpenAI Codex CLI. Install Codex on your computer, and control it from your phone.

Does MobileFlow support Aider?

Yes. MobileFlow supports Aider and other terminal-based AI coding tools. Any CLI tool that runs on your computer can be controlled from your phone.

Is this a mobile IDE?

No. MobileFlow is not a mobile IDE. Your computer runs the coding tools, and your phone acts as a secure remote controller. Code never leaves your machine.

Can I run terminal commands from my phone?

Yes. MobileFlow provides full PTY terminal access. Run any command, see real-time output, and use Ctrl+C to cancel — just like sitting at your desk.

Can I manage Git from my phone?

Yes. You can view diffs, stage changes, commit, push, pull, switch branches, and browse commit history from your phone. Multi-repo support included.

Is my code safe?

Yes. All communication is end-to-end encrypted (AES-256 / NaCl SecretBox). Your code stays on your computer. The phone is just a remote display. No third-party servers involved.

What AI tools are supported?

Claude Code, OpenAI Codex, Aider, Gemini CLI, GitHub Copilot, Kiro CLI, and any terminal-based AI tool. MobileFlow uses the open ACP protocol, so new tools are easy to add.

Keywords

Mobile coding, AI coding agent, Claude Code mobile, Codex mobile, Aider mobile, Gemini CLI mobile, GitHub Copilot mobile, remote coding, phone coding terminal, mobile developer tools, Git from phone, terminal from phone, vibe coding, mobile remote coding, AI pair programming mobile, coding from phone, remote development.

🤝 Contributing

Found a bug? Have a feature request? Open an issue — we read every one.

Pull requests welcome! Please read the contributing guidelines first.

License

MIT

Built with ❤️ for developers who code from anywhere.