GitHub Copilot CLI runs on macOS, Linux, and Windows — there is no iPhone or
Android build, and it fails to install in Termux. So to run it from a phone
you put it on a real Linux machine and reach it. The fastest way: install
Cosyra for iOS or
Cosyra for Android, then npm install -g @github/copilot in the terminal — Node 22+ is already there — authenticate with a token, and
run copilot. GitHub also has a mobile feature, but it only
remote-controls a session running on your own desktop. Here is each path.
Quick decision — pick the path you came for:
- Cloud container (Cosyra) — you want Copilot CLI actually running somewhere your phone reaches, with no desktop left awake. Setup in ~4 minutes ↓
- GitHub's mobile remote control — you already have a desktop awake running a Copilot session and just want to steer it. How that works ↓
- Termux (Android) — you want it on-device and need to know why the install fails today. The pty.node problem ↓
Not sure which fits? The side-by-side comparison ↓ lines them up on what runs where, and what each costs.
This guide was written by the Cosyra team. We checked every moving part against primary sources, the remote-control GA re-verified 2026-06-30: the github/copilot-cli repo, GitHub's Copilot CLI docs and changelog, the npm package, and the open Termux tracking issues #1257 and #3333. Versions and dates below carry that date.
What is GitHub Copilot CLI?
GitHub Copilot CLI is GitHub's agentic coding tool for the terminal. It is
not the old gh copilot extension that suggested shell commands —
it is a full agent that reads your repo, edits files, runs commands, and builds
and tests, with a plan mode and an autopilot mode and support for MCP servers
and custom agents. It ships as the npm package
@github/copilot
and launches with the copilot command.
- Timeline: public preview 2025-09-25, general availability 2026-02-25 (version 1.0.65 as of 2026-06-24).
- Platforms: macOS, Linux, and Windows, plus GitHub Codespaces. No native iOS or Android build exists.
- Prerequisite: Node.js 22 or later — see running Node.js on your phone for why that matters on mobile.
- Safety: GitHub's docs state Copilot will not change your files without explicit approval, and you confirm you trust the working directory first.
Because it is a Node binary that expects a real shell, it has the same mobile problem as every other coding CLI: the phone is the wrong place to run the process. The trick is putting the process somewhere real.
The official "Copilot on mobile" is remote control, not the CLI
This is the part that trips people up. After an April 2026 public preview, GitHub made remote control generally available on 2026-05-18: you "monitor and steer a running CLI session" from the GitHub web app, GitHub Mobile (iPhone, iPad, Android), VS Code, or JetBrains. You press a shortcut in the CLI, scan a QR code, and drive the session from your phone. GA also added support for non-GitHub repositories and standalone directories. It is real and it is handy — but GitHub is explicit about the architecture: the CLI runs on your local machine or workstation, while the mobile device functions as a remote control and monitor.
So the phone is a window onto a session running on a desktop you left awake.
The machine has to stay awake and online for the remote interface to work;
if it sleeps or drops its connection, remote control is unavailable until it
is back, and GitHub ships a /keep-alive command to stop the box from
sleeping mid-run. If you have a desktop you can keep powered on, that fits. If
you do not have a Mac or PC sitting powered-on at home, it does not help — and
that is exactly the gap a cloud container fills. This same remote-control-versus-cloud-container
split shows up across every agent; we map both paradigms in
AI pair programming from a phone.
How can you run Copilot CLI from a phone?
Three ways, in order of how well they work without a desktop: a cloud Ubuntu container where Copilot CLI actually runs (Cosyra), GitHub's remote control of a desktop session, and Termux on Android (which does not currently install).
1. Cosyra: install Copilot CLI in a cloud container
Cosyra is a native iOS and Android terminal connected to a persistent Ubuntu
24.04 container. It ships Node 22+, so npm install -g @github/copilot
works, and the CLI runs in the container — nothing of yours has to stay awake.
- Works when: you want Copilot CLI running on demand from either platform with no home machine to maintain.
- Breaks when: you have no internet, or you specifically need it reaching resources only on your desktop's local network.
- Cost: 1 hour free on signup, no credit card; a 10-hour, 7-day trial; then $29.99/month or $300/year. See pricing. You pay GitHub for Copilot separately.
2. GitHub remote control of a desktop session
The GA feature above (generally available 2026-05-18). Best when you already
run Copilot on a desktop and just want to keep an eye on it or nudge it from
the couch — from GitHub Mobile, the web, VS Code, or JetBrains. Needs that
desktop awake, with /keep-alive to stop it sleeping.
3. Termux on Android — why it fails today
Copilot CLI does not install cleanly in Termux. It bundles a native
pseudo-terminal module, pty.node, and there is no Android arm64
prebuild, so the install fails:
$ npm install -g @github/copilot
Failed to load native module: pty.node
Cannot find module './prebuilds/android-arm64/pty.node'
A GitHub tracking issue for Termux/Android support (#1257) is open and has no committed fix; unofficial community scripts try to
build the native deps by hand. And it got harder, not easier: as of
v1.0.48+ the CLI added a second native module,
runtime.node (a Rust addon that handles token counting, MCP config
parsing, hooks, and session state), compiled against
glibc. Termux's Node is built on Android's Bionic libc, and
you cannot mix glibc and Bionic in one process, so even a patched
pty.node hits a second wall (#3333, open since 2026-05-15; people are pinning to v1.0.45 to dodge it). Even
past both, Android 12+ can kill long-running processes — the same issue we
cover in Cosyra vs Termux. A
cloud x86_64 container sidesteps the whole class of problem.
How do you run Copilot CLI on iPhone or Android with Cosyra?
Four steps: install the app, install @github/copilot,
authenticate with a token, and run copilot in a repo.
Step 1: Install Cosyra and sign in
Download from the App Store or Google Play. The container ships a current Node LTS (Node 22+), which is Copilot CLI's prerequisite.
Step 2: Install GitHub Copilot CLI
Copilot CLI is not one of the four agents we pre-install, but it is one command away because Node is already set up.
$ node --version
v24.4.1
$ npm install -g @github/copilot
added 1 package in 4s
$ copilot --help
GitHub Copilot CLI — agentic coding in your terminal
Step 3: Authenticate with a token
For a container, GitHub recommends a token over interactive login. Create a
fine-grained personal access token with the Copilot Requests
permission, export it, and Copilot picks it up. (Interactively, you can instead
run /login inside the CLI.)
$ # fine-grained PAT with the Copilot Requests permission
$ export GH_TOKEN="github_pat_xxx"
$ echo 'export GH_TOKEN=...' >> ~/.bashrc # persist it
$ copilot
✓ Signed in via GH_TOKEN
GitHub documents this token path as the recommended approach for containers
and non-interactive environments. The precedence, if more than one is set,
is
COPILOT_GITHUB_TOKEN, then GH_TOKEN, then
GITHUB_TOKEN.
Step 4: Clone a repo and run Copilot
$ git clone https://github.com/your-org/your-app.git
$ cd your-app && copilot
Trust the files in this directory? Yes
> Add input validation to the /signup handler
and a test for the empty-email case.
Copilot proposes the edits and waits for your approval before writing. You see the diff on the phone before anything lands on disk — and the persistent container means you can pick the session back up on an iPad later.
Try it free. 1 hour on signup, no credit card. Node 22+ is
ready, so npm install -g @github/copilot just works.
App Store /
Google Play /
Pricing details
What are the real limits of running Copilot CLI on a phone?
- No offline mode. The container is in the cloud; no internet, no terminal.
- A paid Copilot plan is required. GitHub's GA announcement lists the CLI under Pro, Pro+, Business, and Enterprise. That bill is separate from the environment you run it in.
- Phone keyboards slow long prompts. Voice dictation and a Bluetooth keyboard help a lot.
- Autopilot mode is powerful — be deliberate. Copilot can run without per-step approval; on a phone, where one mis-tap approves a lot, keep it on the approval path unless you are watching closely.
Cosyra vs GitHub remote control vs Termux for Copilot CLI
Cosyra runs the CLI for real with nothing left awake; GitHub's remote control is great if a desktop is already running the session; Termux does not install today. The table lines them up, verified 2026-06-28.
| Feature | Cosyra | GitHub remote control | Termux |
|---|---|---|---|
| Copilot CLI actually runs | In the cloud container | On your desktop | Install fails (pty.node) |
| Needs a desktop awake | No | Yes | n/a |
| Platforms | iOS + Android | iOS + Android (as monitor) | Android only |
| Full shell on the phone | Yes | No (steer only) | Yes, but no Copilot |
| Setup time | ~4 min | Desktop session + QR | Does not complete |
| Cost (excl. Copilot plan) | $29.99/mo after trial | Free + your desktop | Free |
Want the full head-to-head on pricing, platforms, and where each tool wins? Our Cosyra vs GitHub Copilot CLI comparison lines them up row by row.
Prefer one of the agents that is pre-installed? See Claude Code on phone, Codex CLI on phone, Gemini CLI on phone, and OpenCode on phone, or the pillar on AI coding agents on mobile. To use any of them for reviewing code, see reviewing pull requests from your phone.
Frequently asked questions
Can you run GitHub Copilot CLI on a phone?
Not as a native app — Copilot CLI supports macOS, Linux, and Windows only, with no iOS or Android build. The two working paths from a phone are installing it in a cloud Linux container (Cosyra), where it genuinely runs and your phone is the terminal, or using GitHub's remote-control feature to steer a session running on your own desktop. Only the container path avoids needing a desktop awake.
[source: GitHub Docs, install Copilot CLI]
Is GitHub Copilot CLI the same as the gh copilot extension?
No. gh copilot is an older GitHub CLI extension that suggests and
explains shell commands. GitHub Copilot CLI is the newer agentic tool — package
@github/copilot, launched with copilot — that edits
files and runs commands across a repo. Public preview 2025-09-25, GA 2026-02-25.
[source: GitHub Changelog, Copilot CLI generally available]
Does GitHub Copilot CLI work in Termux on Android?
No. There are two native-module blockers, and both are open and unfixed as
of 2026-06-28. First, the bundled pty.node module has no Android
arm64 prebuild, so the install fails with a "Cannot find module ./prebuilds/android-arm64/pty.node"
error (issue #1257). Second, since
v1.0.48+ the CLI ships runtime.node, a Rust
addon compiled against glibc that cannot load on Termux's Bionic libc
(issue #3333) — so even a hand-patched pty.node hits a second wall.
Unofficial scripts try to build the deps by hand; people pin to v1.0.45 to dodge
the glibc one. A cloud x86_64 container avoids it entirely.
[source: github/copilot-cli issue #1257, Termux/Android support] [source: github/copilot-cli issue #3333, v1.0.48+ glibc runtime.node]
What does the GitHub Copilot mobile feature actually do?
It is remote control, not the CLI on your phone. It became generally
available on 2026-05-18 (after an April 2026 public preview): you monitor
and steer a Copilot CLI session from the GitHub web app, GitHub Mobile, VS
Code, or JetBrains via a QR code, and GA added non-GitHub repositories.
GitHub states the CLI runs on your local machine or workstation while the
phone is a remote control and monitor — the machine has to stay awake
(there is a /keep-alive command). Useful when a desktop is awake;
not a substitute for running the CLI somewhere your phone reaches.
[source: GitHub Changelog, remote control for Copilot CLI sessions now generally available]
Do you need a paid Copilot plan to use the CLI?
Yes. GitHub's general-availability announcement lists Copilot CLI as available with the Pro, Pro+, Business, and Enterprise plans; on Business and Enterprise an admin enables it in policy settings. You pay GitHub for the Copilot subscription separately from the environment you run the CLI in.
tl;dr
GitHub Copilot CLI is desktop-only (macOS, Linux, Windows) and fails to
install in Termux because its pty.node module has no Android arm64
prebuild. GitHub's mobile feature only remote-controls a session running on
a desktop you leave awake. To actually run the CLI from a phone with nothing
left on at home, install it in a cloud Ubuntu container (Cosyra): npm install -g @github/copilot, authenticate with a
GH_TOKEN, and run copilot.
App Store / Google Play. 1 hour free, no credit card.
Run GitHub Copilot CLI from your phone.
Install Cosyra, npm install -g @github/copilot, and go.