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.
Install the app
Get Cosyra from the App Store or Google Play. Sign in with Apple, Google, or email. Your first hour of compute is free, no credit card.
Open the terminal
You land on a real Ubuntu 24.04 prompt. Node.js, Python, Git, tmux, and vim are already there. Files in your home directory persist across sessions — close the app, get on the train, open it again on the other side, your container resumes.
Run an AI agent
Type claude, codex,
opencode, or gemini and follow the browser
sign-in. After that, you are coding with the same CLI tools you use
on a laptop. For end-to-end walkthroughs, see our
Claude Code on phone guide, the Codex CLI on phone guide, the OpenCode on phone guide, or the Gemini CLI on phone guide.
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.
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
Open the Sidebar
Tap the hamburger menu icon in the top-left corner of the Cosyra interface. This will open the sidebar navigation menu.
Open Your Profile
At the bottom of the sidebar, you will see your profile section. Tap your profile to open the Settings screen.
Select GitHub Integration
Inside the Settings screen, locate and tap GitHub Integration. Cosyra will redirect you to GitHub.com to begin the authorization process.
Authorizing Cosyra on GitHub
Sign In to GitHub
If you are not already logged in, GitHub will prompt you to enter your username/email and password.
Choose Repository Access
GitHub will ask you to choose how Cosyra can access your repositories. Options include:
- All repositories, Cosyra can access every repository in your account.
- Only select repositories, Choose specific repositories to grant Cosyra access.
Install the Integration
After choosing your repository permissions, tap Install. This completes the GitHub authorization process.
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
Locate a Repository
Find the repository on the My Repos screen.
Tap Clone Now
Tap Clone Now to clone the repository into the current working directory.
Wait for Confirmation
A message will confirm the repository was successfully cloned.
Accessing the Project
Navigate into the project using:
cd project-nameYou can now work on the project inside Cosyra.
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.
ESC
Cancel operations, exit prompts, or close terminal interfaces.
TAB
Auto-complete commands and file paths in the terminal.
CTRL
Access common control shortcuts like copy, paste, and interrupt.
ALT
Alternate terminal shortcuts used by some CLI tools.
Arrow Keys
Navigate within commands and scroll through command history.
Microphone
Dictate commands using voice input directly into the terminal.
TAB Auto-Complete
Example:
# Type partial command:
git clo
# Press TAB to auto-complete:
git cloneCTRL Shortcuts
| Shortcut | Action |
|---|---|
Copy | Copy terminal output |
Paste | Paste clipboard contents |
Ctrl + C | Interrupt a running process |
Ctrl + D | End the terminal session |
Shift + Tab | Toggle Claude Plan Mode |
F12 | Toggle debug or console panels |
Ctrl + A | Jump to start of line |
Ctrl + E | Jump to end of line |
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.
Tap the microphone button
Begin voice recording.
Speak your command
Dictate the terminal command you want to run.
Tap the microphone button again
Stop recording. The spoken text will appear in the terminal input field.
Keyboard Close Button
Closes the mobile keyboard to allow more space to view terminal output.
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:appRunning a Project Using an AI Agent
You can also ask AI agents (Claude, Codex, Gemini) to run the project. Example prompt:
The AI agent will determine the correct command to start the server.
Opening the Localhost Preview
Run your development server
Start the server using the appropriate command for your project.
Open the sidebar
Tap the hamburger menu icon.
Locate the Localhost section
Find and tap the running task under the Localhost section.
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:
Connecting and Logging In to AI Agents
Overview
We ship four AI coding agents pre-installed in the container so you can run them directly from the terminal — no Node or Python setup first:
Before using an agent, you authenticate with that provider's account. Cosyra is BYOK — you pay Anthropic, OpenAI, or Google directly for model usage; we do not proxy or meter that bill.
Starting an AI Agent
Run the agent command:
claude
# or
codex
# or
opencode
# or
geminiLogging In
If not logged in, the CLI will display login options.
Choose Login Method
Select login with an existing account. The CLI will generate an authorization link.
Open Authorization Link
Tap the link to open a browser.
Sign In
Log in to your AI platform account and approve authorization.
Copy Verification Code
A code will be generated after authorization. Copy the code.
Return to Cosyra
Go back to the terminal.
Paste the Code
Tap CTRL → Paste.
Submit
Press Enter. If successful, the CLI confirms authentication.
Using the AI Agent
Once logged in, you can interact with the agent directly in the terminal:
- Generate code
- Debug issues
- Run commands
- Analyze projects
// recap
Summary
Cosyra is the mobile development environment we wanted on the train and never had. The pieces above cover the parts you touch every day:
- GitHub integration
- AI coding agents
- Localhost project previews
- A powerful mobile terminal toolbar
Build, test, and manage real projects from the phone in your hand — waiting room, couch, commute.