Skip to content

// guides

Run Warp Terminal on Your Phone (iPhone + Android)

You cannot run Warp terminal on a phone, because Warp ships desktop builds only: macOS, Linux, and Windows. There is no iOS, iPadOS, or Android app, and the one mobile surface, Warp Drive on the web, can view your saved workflows and session transcripts but cannot run a command. What you can do is get the thing Warp gives you at a desk, an agentic terminal, on a phone: open a cloud Ubuntu container from Cosyra for iOS or Cosyra for Android and drive the agent CLIs that come pre-installed. 1 hour free on signup, no credit card.

This guide was written by the Cosyra team. We cross-checked every claim about Warp against the official Warp download page, the warpdotdev/warp repo, and Warp's open-source announcement, all verified 2026-06-03. Where Warp is genuinely ahead of us, we say so.

The distinction that matters: "Warp on a phone" and "an agentic terminal on a phone" are not the same request. The first does not exist and is not on a public roadmap. The second is just a real Linux shell with an agent in it, reached from a native app. We built the second. If you came here because you love Warp at your desk and want it in your pocket, the honest answer is that the app is desktop-only, and the useful answer is below.

Decision diagram showing Warp runs fully only on macOS, Linux, and Windows; on a phone no Warp app exists and Android has been requested since 2023 in issue 3328; Warp Drive on the web views workflows and transcripts but cannot run commands; the thing that actually runs on a phone is a cloud Ubuntu container with Claude Code, Codex CLI, OpenCode, and Gemini CLI pre-installed.
Where Warp runs and why a phone needs a cloud container instead, verified 2026-06-03 against warp.dev/download and warpdotdev/warp issues #3328 and #8037. Diagram, not a screenshot.

What is Warp?

Warp is an agentic development environment built around the terminal. It is a GPU-rendered desktop terminal written in Rust with a built-in AI agent that can run local and cloud coding agents across different models. Its signature features are blocks (each command and its output grouped as a unit you can scroll, copy, and share), a command palette, AI autocomplete, and Warp Drive, a knowledge layer for saved workflows and prompts. The repo sits at about 61,000 GitHub stars as of 2026-06-03, and third-party reporting around the open-source launch put usage near a million developers. It is genuinely one of the best terminals you can put in front of a developer.

Two facts about Warp's reach are worth stating plainly, because confusion about them is exactly why people search for "Warp on phone." First, Warp can dispatch coding agents to run in the cloud, so it is not a purely local-only tool. Second, and separately, the interactive terminal you actually type into runs only on a desktop OS. Those are different things. Warp touches the cloud; the Warp client you drive does not run on a phone.

The opinion we hold that a Warp loyalist will push back on: for mobile coding, the terminal client is the wrong unit to obsess over. Warp's polish lives in the desktop window manager, the blocks, the keyboard-driven palette. On a phone you are not getting that window anyway, so the question that matters is not "which terminal" but "where does the shell live." Warp fans who think the editor or the terminal chrome is the point will disagree. We think, on a phone, the shell's location is the whole game, and a hosted Linux box you reach from a native app beats any client that has no mobile build at all.

Why is there no Warp on a phone?

There is no Warp on a phone because Warp has never shipped a mobile build, and the requests for one have not turned into a roadmap. The download page lists Mac, Linux, and Windows installers only. The two relevant GitHub issues tell the rest of the story:

Warp is not the only desktop agentic tool stuck here. Zed and Windsurf both run the same agent CLIs at a desk and both ship desktop-only, with no mobile build either. The fix is identical in each case: put the shell in a cloud container and reach it from a native app.

The closest thing to a mobile surface is Warp Drive on the web. It is worth being precise about what that is: a browser view of Warp Drive objects (workflows, notebooks, prompts) and shared session transcripts. You can read and edit those objects, but you cannot open a shell, run a command, or drive an agent from it. It is a place to look at your saved work, not a terminal.

How do you get an agentic terminal on iPhone or Android?

You get an agentic terminal on iPhone or Android by putting the shell in the cloud and reaching it from a native app. With Cosyra that takes about four minutes: install the app, open the container, pick an agent CLI, add your API key, and start a session. The agent CLIs we pre-install are the part that gives you the Warp-style "agent in my terminal" loop without any setup.

Step 1: Install Cosyra and open a container

Download from the App Store or Google Play and sign in with Apple, Google, or email. On first launch we provision a fresh Ubuntu 24.04 x86_64 container with Node.js, Python, Git, and tmux already on it.

cosyra, fresh container first-launch banner

Welcome to Cosyra.

Ubuntu 24.04.1 LTS (x86_64)

Pre-installed: claude, codex, opencode, gemini

A real shell — the thing Warp's web view is not.

Step 2: Pick the agent you want to drive

Warp's whole pitch is an agent living inside your terminal. We pre-install four agent CLIs so you do not have to assemble that yourself. Run whichever matches the model you pay for.

cosyra, the four pre-installed agents

$ claude --version # Anthropic Claude Code

$ codex --version # OpenAI Codex CLI

$ opencode --version # open-source agent

$ gemini --version # Google Gemini CLI

Step 3: Add your provider API key (BYOK)

The agents are bring-your-own-key, so you export the key for whichever model you use and write it into your shell config once. It persists in the container's home volume across sessions and across your phone, tablet, and the web. We do not proxy or meter model billing; you pay your provider.

cosyra, setting a provider key

$ echo 'export ANTHROPIC_API_KEY="your-key-here"' >> ~/.bashrc

$ source ~/.bashrc

# OpenAI, Gemini, or other providers work the same way

Step 4: Clone a repo and start a session

Clone your repository, cd into it, and start the agent. You describe the change, it edits files and runs commands in the same shell. This is the agentic-terminal loop, running on a phone.

cosyra, an agent session on a phone

$ git clone https://github.com/your-org/your-project.git && cd your-project

$ claude

> Add a --dry-run flag to the deploy script and update the README

Edited scripts/deploy.sh and README.md. Run the script to confirm.

Step 5: Keep it running with tmux

Wrap long sessions in tmux so a dropped signal or a locked phone does not kill the agent mid-task. The session keeps running on the container; you re-attach when you come back.

cosyra, surviving a dropped connection with tmux

$ tmux new -s warp

# ...phone locks on the train, signal drops...

$ tmux attach -t warp

# right back in the session, agent still working

Try it free. 1 hour on signup, no credit card. Extend with a 10-hour, 7-day trial when you want more. Claude Code, Codex CLI, OpenCode, and Gemini CLI come pre-installed, so the agentic part is ready the moment the container boots. App Store / Google Play / Pricing details

What does this actually feel like on a phone?

The honest pitch is an agent session you can start anywhere and a real shell underneath it. Three places we run it.

A fix on the train, committed before your stop

You noticed a bug on the way out. On the train, open Cosyra, cd into the repo, run claude, and describe the fix. It edits the file and you commit it. By the time you are off the train, the change is a reviewable commit on the branch instead of a note you have to act on later.

A refactor from the couch with the agent doing the typing

Saturday morning, phone in hand. Point an agent at a module: "split this file into a parser and a formatter, keep the public API the same." The agent runs the edits and the tests in the same shell, and you review the diff on the phone before keeping it. The small on-screen keyboard barely matters because you are describing intent, not typing every line.

Checking a long task from the waiting room

You kicked off a build or a long agent run before leaving. From a waiting room, attach to the tmux session and watch it finish, or steer it if it went sideways. The container kept running while your phone was in your pocket. For the cross-agent picture, see the AI coding agents on mobile pillar.

What are the real limits here?

This setup is not Warp, and it is not trying to be. Knowing where it stops helps you match it to the right job.

How does Cosyra compare to Warp?

These are different shapes, not a head-to-head. Warp is the best terminal you can run at a desk; Cosyra is a hosted Linux box you reach from a phone. The comparison below is about surfaces, not "which terminal is better." Current as of 2026-06-03.

Feature Warp Cosyra
Runs on a phone No (desktop only) Yes (native iOS + Android)
Platforms macOS, Linux, Windows iOS, Android, web
Interactive terminal on mobile No (Drive web is view-only) Yes (real Ubuntu shell)
Agents One integrated Warp Agent 4 CLIs pre-installed (BYOK)
Open source Yes (AGPL-3.0 since 2026-04-30) No (managed SaaS on Azure)
Works offline Yes (local terminal) No (cloud container)
Persistent hosted workspace No (tied to your machine) Yes (30 GB, follows you)
What the price buys Free terminal; AI credits metered (Build $20/mo) The machine: $29.99/mo, 120 hrs, 30 GB

A note on price, because it is easy to compare wrong: Warp's terminal is free and only its agent usage is metered in credits, so you are paying for AI on a machine you already own. Cosyra's $29.99/month buys the machine itself, the hosted Ubuntu container and its storage, and your model tokens are still billed by your provider on top. They are not a like-for-like dollar comparison.

Who should pick which?

Choose Warp if you are at a desk and want the best terminal UX available, you value open source and the ability to inspect or self-build the client, or you want one integrated agent layer you configure across models. Warp is the better tool for the laptop, and we will not pretend otherwise.

Choose Cosyra if you want to actually run an agentic terminal from your phone on the train, the couch, or a waiting room, you want Claude Code, Codex CLI, OpenCode, and Gemini CLI sitting in one container with no install step, or you want a persistent Linux box that follows you across iPhone, Android, and web. Many people run both: Warp at the desk, Cosyra when the laptop is closed.

Try Warp first if your work happens almost entirely at a desk, you want a polished local terminal more than a remote one, or you specifically want an open-source client you can audit. For the open-source agent angle on the Cosyra side, see OpenCode on phone, and for the most-searched agent, Claude Code on phone. If you are weighing the broader question of what a real terminal on a phone even looks like, start with the mobile coding terminal pillar.

Frequently asked questions

Can you run Warp terminal on a phone?

No. Warp ships desktop builds only, macOS, Linux, and Windows, and there is no iOS, iPadOS, or Android app. The single mobile surface is Warp Drive on the web, which views saved workflows and shared session transcripts but cannot open a shell or run a command. To get an agentic terminal on a phone you run the agent CLIs on a real Linux box and reach it from a mobile app, which is what a cloud container does.

Does Warp have an Android app?

No. Android support has been requested since July 2023 in issue #3328 on the warpdotdev/warp repo, which is still open with 19 comments as of 2026-06-03. A later "Warp for Mobile" request, issue #8037, was closed as a duplicate with no roadmap commitment. There is no Android build to install.

Is there a Warp app for iPhone or iPad?

No. Warp's download page lists Mac, Linux, and Windows installers only, with no App Store listing, as of 2026-06-03. There is no iOS or iPadOS version, and Warp Drive on the web is a viewer for workflows and transcripts, not a terminal you can type commands into.

Can Warp Drive on the web run commands from my phone?

No. Warp Drive on the web is read and edit access to Warp Drive objects (workflows, notebooks, prompts) plus shared session transcripts. Warp's own docs describe it as a browser view of those objects, not an interactive terminal, so you cannot open a shell, run a command, or drive an agent from it.

Is Warp free, and is it open source?

Warp's terminal is free to use, and Warp went open source on 2026-04-30 under AGPL-3.0 (the UI crates are MIT, and OpenAI is the founding sponsor). What is metered is AI usage: paid tiers like Build ($20/mo) include a monthly credit allowance for cloud and local agents. The terminal itself does not require a subscription.

How do I use Warp's AI agent from my phone, then?

You cannot run Warp's client on a phone, so you run an equivalent agentic-terminal loop instead: open a cloud Ubuntu container from a native app and drive Claude Code, Codex CLI, OpenCode, or Gemini CLI from it. The agent edits files and runs commands in a real shell, which is the same loop Warp gives you at a desk, on a surface that actually exists on a phone.

tl;dr

Warp is one of the best desktop terminals, open source under AGPL-3.0 since 2026-04-30, but it has no mobile app: Mac, Linux, and Windows only, and Warp Drive on the web cannot run commands. Use Warp if you live at a desk. Use Cosyra if you want the agentic-terminal loop on a phone: install the app, open the container, run Claude Code, Codex CLI, OpenCode, or Gemini CLI, and bring your own provider key. Many people run both.

App Store / Google Play. Sign up for 1 hour free, no credit card. Extend with a 10-hour, 7-day trial when you want more.

Run an agentic terminal from your phone. Install Cosyra, open the container, run an agent CLI, start coding.

See pricing