Run Claude Code and Codex CLI from your phone

Quick Start

From a clean install to a working Claude Code session takes about a minute on a phone with good network. Cosyra ships the Linux side ready, so you only sign in to the app and sign in to the AI provider.

If you want to know how this slots in against local options like Termux, iSH, or Blink Shell, the mobile coding terminal pillar page lays out the trade-offs.

AI Agents

Cosyra runs the agent you already use. Claude Code, Codex, Antigravity and OpenCode each have a shortcut card on Terminals. The Cursor CLI is installed too and starts from a terminal. Anything else, such as Pi, installs with one command.

You sign in to each agent with your own account and pay that provider directly for model usage. We do not proxy or meter that bill.

Every agent below links to its guide, which has the screens for each step.

Add your own agent

Any CLI you install can have its own card. On Terminals, tap the plus next to Your shortcuts, give it a name and set the command. One tap then opens a terminal in the folder you chose and runs it. The Pi guide and the Cursor CLI guide show the sheet.

Choosing between agents? AI coding agents on mobile compares them, and the guides page has the full list.

Connecting Your GitHub Account and Cloning Repositories

Overview

Connect your GitHub account in Cosyra to access and work with your repositories directly from a mobile device. Once connected, you can browse your repositories inside the app and clone them into your Cosyra workspace to start working immediately.

This integration enables you to manage and modify your projects without needing a desktop or laptop environment.

When You Would Use This Feature

You should connect your GitHub account when you want to:

• Access your existing repositories inside Cosyra
• Clone projects to work on while away from your computer
• Use AI agents to assist with development inside your codebase
• Review and modify project files on the go

Once your GitHub account is connected, Cosyra can load your repositories and allow you to clone them directly into your terminal workspace.

Prerequisites

Before connecting GitHub, ensure that:

• You have an active GitHub account
• You are signed in to Cosyra
• You have a stable internet connection

Connecting Your GitHub Account

Authorizing Cosyra on GitHub

Returning to Cosyra

Return to the Cosyra app and navigate to Settings → GitHub Integration. This will open the My Repos screen.

Viewing Your Repositories

The My Repos screen shows repositories you granted access to. Each repository includes a Clone Now option.

Cloning a Repository

Accessing the Project

Navigate into the project using:

cd project-name

You can now work on the project inside Cosyra.

Guides Git from your phone

Terminal Toolbar

Overview

The Cosyra Terminal Toolbar sits above the mobile keyboard and provides quick access to important terminal controls that are normally only available on physical keyboards.

TAB Auto-Complete

Example:

# Type partial command:
git clo

# Press TAB to auto-complete:
git clone

CTRL Shortcuts

Arrow Keys

• Up Arrow, view previous command
• Down Arrow, move forward in history
• Left Arrow, move cursor left
• Right Arrow, move cursor right

Microphone (Voice Dictation)

When first used, Cosyra will download the speech model required for voice input. This is a one-time setup. The device may request microphone permissions.

Keyboard Close Button

Closes the mobile keyboard to allow more space to view terminal output.

Guides Mobile coding terminal: the complete guide

Localhost Preview

Overview

Run a development server inside the container and preview it inside the Cosyra app. When a project starts listening on localhost, the app detects the port and shows the task under the Localhost section in the sidebar.

When You Would Use This Feature

Use this feature when running development servers such as:

npm run dev
npm start
python -m http.server
uvicorn main:app

Running a Project Using an AI Agent

You can also ask AI agents (Claude Code, Codex, Antigravity) to run the project. Example prompt:

The AI agent will determine the correct command to start the server.

Opening the Localhost Preview

Closing the Preview

Tap the X icon in the top-right corner. You will return to the terminal.

No Local Apps Detected

If nothing is running on localhost, the sidebar will display:

Deploy to the Internet

Overview

Your Cosyra workspace is a full Ubuntu machine, so shipping a project works the same way it does on a laptop: with the deployment provider's own CLI. The Connectors screen handles the part that is painful on a phone, authentication. You paste a token once, and Cosyra keeps the provider CLI signed in inside your workspace.

Supported Providers

Cosyra ships deploy connectors for six providers. Connecting one stores your token securely, exports it as the environment variable the provider's CLI expects, and installs the CLI in your workspace:

• Vercel: VERCEL_TOKEN, installs the vercel CLI
• Netlify: NETLIFY_AUTH_TOKEN, installs netlify-cli
• Render: RENDER_API_KEY, installs the render CLI
• Fly.io: FLY_API_TOKEN, installs flyctl
• Railway: RAILWAY_API_TOKEN, installs the railway CLI
• Cloudflare: CLOUDFLARE_API_TOKEN, installs wrangler

Connecting a Provider

Deploying with Vercel

From the terminal, in your project directory:

# First deploy links the project, then ships a preview
vercel --token "$VERCEL_TOKEN"

# Production deploy
vercel --prod --token "$VERCEL_TOKEN"

The full walkthrough, including custom domains and environment variables, is in the Deploy to Vercel from your phone guide.

Deploying with Render

Render deploys are driven by Git: pushing to the branch connected to your Render service triggers a deploy. The CLI reads RENDER_API_KEY automatically, so you can trigger and watch deploys without leaving the terminal:

# Push to deploy (service connected to this repo)
git push origin main

# Or trigger and watch from the CLI
render services
render deploys create <service-id> --wait

See the Deploy to Render from your phone guide for the end-to-end setup.

Deploying with an AI Agent

Once a provider is connected, the agents can drive the deploy. Example prompt:

The agent runs the provider CLI with the token that is already in the environment, and reports the deploy URL back in the chat.

Disconnecting

Disconnecting a provider from the Connectors screen deletes the stored token and removes the environment variable from your workspace. The CLI stays installed but is signed out.

Manual Setup

Connectors are a convenience, not a requirement. You can always install a provider CLI yourself (for example npm install -g vercel) and export the token in your shell. The Deploy a website from your phone guide compares every path.

Guides VercelRenderNetlifyCloudflare Pages

Use the Claude Connector to move your session to your Cosyra Workspace

Overview

You are talking to Claude on a laptop, the conversation is going somewhere, and you have to leave. Cosyra publishes an MCP connector that moves the whole chat into your workspace, where it reopens as a Claude Code session in a terminal on your phone.

The connector is a remote MCP server. Nothing installs on your machine, and it needs no sign-in of its own: the claim step on the phone is what proves the session is yours.

Adding the Connector

In claude.ai, open Settings, then Connectors, and add Cosyra from the connector directory. The listing is in review with Anthropic and appears there once approved. The same listing works in Claude Code and Claude Desktop.

Handing Over a Conversation

Ask Claude to continue the chat in Cosyra. It calls the continue_in_cosyra tool, packs the conversation, and hands you back three ways to pick it up:

The link and the code are single-use and expire after an hour. Your workspace wakes with the conversation already loaded, so you can reply to it and keep going.

If You Do Not Have the App Yet

You must be signed in to the Cosyra app to claim, so install and sign in first, then claim. Scan the QR code or open the install page, get the app from the App Store or Google Play, sign in, then enter the claim code.