Create
Register with email on web or mobile.
$ teamflow codex
session created · codex in ~/project
Analyzing task files...
Awaiting approval from phone
TeamFlow
Live
Mac online
Codex in ~/project
Analyzing task files... Need approval to edit.
Type a reply...
AI coding sessions, live on your phone
Your Mac terminal, always in your pocket.
Start Codex or Claude on your Mac. Watch the session live from mobile, send commands, and reconnect through a background agent when the terminal window closes.
Install
Run one command on your Mac.
Resume
Control Codex or Claude from phone.
Android app
Install the internal Android build.
Download the APK on your Android phone, open it, allow installation from the browser if Android asks, then sign in with the same account.
TeamFlow Android
Version 0.1.0
Mac install
One script, one account, live sessions.
- Open the Terminal app on your Mac.
- Copy the command on the right and paste it into Terminal.
- Wait until it prints the next steps. It can install Node.js and tmux through Homebrew if they are missing.
curl -fsSL /install.sh?email=you%40example.com | bashSetup guide
From zero to your first mobile terminal session.
Follow these steps in order. Use the same email and password on the website, Android app, and Mac agent.
Create your account
Open Create account, register with email and password, then continue from the workspace.
Install the Android app
Open this page on Android, tap Download APK, open the downloaded file, and choose Allow from this source if Android asks.
Install the Mac agent
On your Mac, open Terminal and paste the install command. It installs the agent, then runs teamflow setup --email to log in, install the service, and upload diagnostics.
Start Codex or Claude
Run teamflow codex or teamflow claude on your Mac. Open the Android app to watch output and send input from your phone.
Before you start
Prepare an Android phone, your Mac, and one email/password. The phone does not need to be on the same Wi-Fi as the Mac.
Install on Android
Open this website on the Android phone, tap Download APK, open the downloaded file, allow browser installation if prompted, then open TeamFlow and sign in.
Install on Mac
On the Mac, open Terminal, paste the install command, and press Enter. The script will run teamflow setup --email and ask for your password.
Use it the first time
Run teamflow codex or teamflow claude on the Mac. On Android, open Sessions, tap the active session, watch the output, and type replies in the input bar.
Common fixes
- If Terminal says teamflow cannot be found, close and reopen Terminal, or add ~/.local/bin to PATH.
- If the app cannot sign in, check that the phone can open this website and that the email/password match.
- If the phone shows no sessions, run teamflow doctor on the Mac, then start a session with teamflow codex or teamflow claude.
If something fails
Run teamflow doctor on the Mac first. It checks the relay address, login state, background service, Node.js, and tmux.
Live terminal sessions
Follow output, send input, and reopen recent events from mobile.
Encrypted event payloads
Terminal payloads are encrypted before storage.
Device binding
Each Mac is bound to your personal workspace.
Background reconnect
The desktop service restores bridges to running tmux sessions.
Built for your current CLI workflow.
TeamFlow does not replace Codex, Claude, tmux, or your shell. It adds a secure mobile control surface on top of the tools you already run locally.