How to Run AI Coding Agents on Your Phone

You can run Claude Code, Codex CLI, OpenCode, and Gemini CLI on your phone right now. Install Cosyra for iOS or Cosyra for Android, add your API keys, and you get a full Ubuntu container with all four agents pre-installed. No SSH setup, no always-on laptop, no browser tabs that time out. We built this because we kept wanting to check on agent work from the couch or approve a Claude Code permission request while walking the dog, and the existing options were either fragile SSH chains or monitor-only dashboards.

This guide covers why phone-based AI coding works, how each agent runs on mobile, three approaches you can take, and step-by-step setup on Cosyra. Free trial, 10 hours, no credit card.

Why AI coding agents change the phone equation

The standard objection to coding on a phone is the keyboard. Fair point, if you're the one typing every semicolon. But AI coding agents flipped the ratio. With Claude Code or Codex CLI, you describe what you want in plain language and the agent writes the code, runs the tests, and proposes a diff. Your job is to direct, review, and approve. That interaction model, short prompts in, long outputs out, works on a phone because you're reading more than you're typing.

We think the phone keyboard is fine for agent-driven coding. Most developers who disagree haven't tried it with a properly set up agent that handles the boilerplate. When you're on the train reviewing a PR, or between meetings approving a Codex refactor, the phone is not a compromise. It's the fastest path between "I have five minutes" and "that shipped."

The practical scenarios where this matters:

• Monitoring long-running agent tasks. Claude Code working through a large refactor takes 10-20 minutes. You don't need to stare at a laptop for that. Check in from your phone, approve the permission it's waiting on, and get back to your coffee.
• Quick fixes and reviews. A bug report comes in while you're away from your desk. Open the terminal, point Claude Code at the issue, review the fix, push. Done before you get home.
• Learning and experimentation. You read about a new library on the bus. Spin up a scratch project, ask the agent to scaffold it, poke around. The container persists, pick it up later on any device.

The four agents: what each one does

Cosyra pre-installs four AI coding agents. All of them use BYOK (bring your own key), you connect your own Anthropic, OpenAI, or Google API key and pay the provider directly at their standard rates. Cosyra itself charges for compute, not AI tokens.

You don't have to pick one. All four are installed in the same container. Start a task with Claude Code, try a different approach with Codex, use OpenCode with a local model for private code. The container state is shared , they all see the same files, same git history, same environment variables.

Three approaches to AI agents on your phone

Before we walk through the Cosyra setup, here's how the landscape breaks down. Each approach has real trade-offs.

1. SSH from phone to a desktop or VPS

The classic approach: run the agent on a "real" machine and SSH in from Blink Shell (iOS) or Termux (Android). Add Tailscale for networking and tmux for session persistence.

• Upside: Full control, use your existing dev machine, free if you already have the hardware.
• Downside: Requires an always-on machine. If your MacBook sleeps or your VPS reboots, the session dies. Setup takes 15-30 minutes per machine. You're debugging networking instead of writing code.

This is the approach described in most existing guides, SSH + Tailscale + tmux + Blink. It works if you have a reliable server. We used it ourselves for months before building Cosyra.

2. Browser-based cloud IDEs on mobile

GitHub Codespaces and code-server run VS Code in a mobile browser. You get a full editor, terminal, and extensions.

• Upside: VS Code ecosystem, extensions, GitHub-native integration.
• Downside: Browser UIs on mobile are painful, tiny targets, constant mis-taps, Safari's address bar eating screen space. Codespaces free tier gives 120 hours/month (as of 2026-04-15) but the browser experience on a phone is optimized for desktop screens, not 6-inch touch displays.

3. Native cloud terminal with agents pre-installed

This is what we built with Cosyra. A native iOS and Android app that connects to a persistent Ubuntu container in the cloud. Claude Code, Codex CLI, OpenCode, and Gemini CLI are pre-installed. The terminal UI is designed for touch, with larger tap targets, swipe gestures, and a toolbar row for common keys.

• Upside: Zero setup for agents, native mobile experience, container persists across sessions (30 GB storage, session hibernation).
• Downside: Paid service ($29.99/month after free trial). Requires internet, no offline mode. You're running on our infrastructure, not your own.

Setting up each agent on Cosyra

The setup takes about two minutes per agent. Here's what it looks like.

Step 1: Install and start a container

Download Cosyra from the App Store or Google Play. Create an account (email or Sign in with Apple/Google). The app provisions your Ubuntu container on first launch. In our testing, that took about 15 seconds.

Step 2: Add your API keys

Each agent needs its own API key. In the Cosyra terminal, set them as environment variables. They persist across sessions.

For OpenCode, configure your provider in its config file, it supports 75+ LLM providers including local models. See the OpenCode docs for provider setup.

Step 3: Clone a repo and start coding

That's it. The container has git, node, python, go, rust, and common dev tools pre-installed. Your files persist on 30 GB of storage. If the app goes to background, session hibernation keeps your work intact.

Switching between agents

All four agents are regular CLI tools. Switch between them like you would on a laptop:

A real workflow: reviewing a PR from the train

Here's a scenario we run through regularly. It's 8:40 AM, you're on the train to the office, and a teammate tagged you on a PR that needs review before standup at 9.

1. Open Cosyra on your phone. Your container is still running from yesterday.
2. cd into the project. git fetch && git checkout pr-branch.
3. Run claude and ask: "Review the diff between main and this branch. Focus on security issues and missing tests."
4. Claude Code reads every changed file, checks the test coverage, and gives you a structured review with specific line references.
5. You read the review on your phone, approve the PR with a comment referencing Claude's findings, and push a small fix Claude suggested.
6. You walk into standup at 9 having already reviewed and improved the PR. Total phone time: 6 minutes.

The agent did the heavy reading. You made the decisions. That's why the phone works, it's a command interface for an agent that does the actual typing.

Tips for phone-based agent work

• Use agent-first workflows. Don't try to write code character by character. Describe what you want in a sentence, let the agent generate, review the output. This is faster on a phone than manual editing on a laptop for many tasks.
• External keyboard is optional. For sessions longer than 20 minutes, a Bluetooth keyboard helps. For quick reviews and approvals, the phone keyboard is enough. We've shipped production fixes from the waiting room at the dentist with just a thumb.
• Use tmux inside the container if you want multiple terminal panes. Cosyra's container includes tmux pre-installed. tmux new -s work gives you split panes, one for the agent, one for watching test output.
• Commit and push from the container. The container has full git support. Connect your GitHub account via the Cosyra app (see Docs) and push directly.
• Session hibernation saves your state. Close the app, come back hours later, and your terminal session, running processes, and files are exactly where you left them. No reconnecting, no tmux reattach.

How this compares to other mobile coding options

Each option wins somewhere. Termux is unbeatable on price and offline capability. Codespaces is free and integrates with GitHub. SSH gives you maximum control. Cosyra's edge is that the agents work out of the box on a phone, no server maintenance, no browser compromises, no ARM compatibility issues. For a deeper look at Claude Code specifically, see our guide on how to run Claude Code on your phone.

Frequently asked questions