Skip to content

Documentation

Get started with Cosyra

A mobile development terminal for developers and AI builders. Manage projects, run AI agents, preview applications, and interact with GitHub — all from your phone.

Connecting Your GitHub Account and Cloning Repositories

Overview

Cosyra allows you to connect your GitHub account so you can access and work with your repositories directly from your mobile device. Once connected, you can view your repositories inside the app and clone them into your Cosyra workspace to begin development 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

1

Open the Sidebar

Tap the hamburger menu icon in the top-left corner of the Cosyra interface. This will open the sidebar navigation menu.

2

Open Your Profile

At the bottom of the sidebar, you will see your profile section. Tap your profile to open the Settings screen.

3

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

1

Sign In to GitHub

If you are not already logged in, GitHub will prompt you to enter your username/email and password.

2

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.
3

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

1

Locate a Repository

Find the repository on the My Repos screen.

2

Tap Clone Now

Tap Clone Now to clone the repository into the current working directory.

3

Wait for Confirmation

A message will confirm the repository was successfully cloned.

Accessing the Project

Navigate into the project using:

bash 
cd project-name

You 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

ESC

Cancel operations, exit prompts, or close terminal interfaces.

TAB

TAB

Auto-complete commands and file paths in the terminal.

CTRL

CTRL

Access common control shortcuts like copy, paste, and interrupt.

ALT

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:

bash 
# Type partial command:
git clo

# Press TAB to auto-complete:
git clone

CTRL Shortcuts

Shortcut Action
CopyCopy terminal output
PastePaste clipboard contents
Ctrl + CInterrupt a running process
Ctrl + DEnd the terminal session
Shift + TabToggle Claude Plan Mode
F12Toggle debug or console panels
Ctrl + AJump to start of line
Ctrl + EJump 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.

1

Tap the microphone button

Begin voice recording.

2

Speak your command

Dictate the terminal command you want to run.

3

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

Cosyra allows you to run development servers and preview applications directly inside the app. When a project runs on localhost, Cosyra 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:

bash 
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, Codex, Gemini) to run the project. Example prompt:

"Run this project on localhost"

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

Opening the Localhost Preview

1

Run your development server

Start the server using the appropriate command for your project.

2

Open the sidebar

Tap the hamburger menu icon.

3

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:

No local apps detected.

Connecting and Logging In to AI Agents

Overview

Cosyra allows developers to run AI coding agents inside the terminal. Supported agents include:

Claude Code

by Anthropic

Codex

by OpenAI

Gemini CLI

by Google

Before using an agent, you must authenticate with your AI platform account.

Starting an AI Agent

Run the agent command:

bash 
claude
# or
codex
# or
gemini

Logging In

If not logged in, the CLI will display login options.

1

Choose Login Method

Select login with an existing account. The CLI will generate an authorization link.

2

Open Authorization Link

Tap the link to open a browser.

3

Sign In

Log in to your AI platform account and approve authorization.

4

Copy Verification Code

A code will be generated after authorization. Copy the code.

5

Return to Cosyra

Go back to the terminal.

6

Paste the Code

Tap CTRL → Paste.

7

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

Summary

Cosyra provides a full mobile development environment including:

  • GitHub integration
  • AI coding agents
  • Localhost project previews
  • A powerful mobile terminal toolbar

This allows developers to build, test, and manage projects directly from their phone.