DocsBlogSecurityGitHub
docs

Termly Documentation

Termly is a free CLI that mirrors any terminal-based AI coding assistant — Claude Code, OpenCode, GitHub Copilot — to your iPhone, iPad, or Android with AES-256-GCM end-to-end encryption. Setup in under 60 seconds.
Last updated: March 2026
// overview
Browse by topic
Getting Started
New to Termly? Start here to get up and running in minutes.
Supported AI Tools
Termly works with all major terminal-based AI coding assistants.
Security & Privacy
Understand how Termly protects your code and data.
Troubleshooting
Common issues and solutions for connection and performance.
// quick-reference
Jump to
// getting-started

Installation

Install the Termly CLI on your development machine (Mac, Windows, or Linux) and the Termly app on your mobile device.

1. Install Termly CLI

Run this in your terminal:

terminal
$npm install -g @termly-dev/cli

2. Install Mobile App

Download Termly on your mobile device:

3. Start Your First Session

Navigate to your project directory and launch Termly:

terminal
$cd /path/to/your/project
$termly start

A QR code will appear in your terminal. Open Termly on your phone, scan the code, and you're connected.

// ai-tools

Claude Code Integration

To use Claude Code with Termly, specify the AI tool when starting:

terminal
$termly start --ai claude-code

For a complete guide, see our Claude Code on Mobile use case.

// ai-tools

Google Gemini Integration

Google Gemini Code Assist can be accessed through Termly. If you're using Gemini via terminal:

terminal
$termly start --ai gemini

Termly supports any Gemini-based CLI tool or terminal interface, giving you mobile access to Google's powerful AI coding assistant.

// ai-tools

GitHub Copilot Integration

GitHub Copilot CLI brings AI pair programming to your terminal. If you're using Copilot CLI on your computer, Termly lets you access it from your mobile device:

terminal
$termly start# auto-detect

Any Copilot CLI commands you run in your terminal will be accessible through Termly on your phone, with full support for voice input and mobile editing.

// ai-tools

Other AI Tools

Termly works with any terminal-based AI coding assistant. Popular tools:

OpenCodeCursorGrokOpenAI Codex
  • OpenCode: AI pair programming in your terminal
  • Cursor: AI-first code editor with terminal mode
  • Grok: xAI's coding assistant
  • OpenAI Codex: Terminal interface for GPT-4

If your AI tool runs in a terminal, Termly can mirror it to mobile. Use termly start and let auto-detection handle the rest.

// security

Encryption Details

Termly uses end-to-end encryption to protect your code during transmission:

  • AES-256-GCM: Industry-standard symmetric encryption
  • Diffie-Hellman Key Exchange: Secure key generation between devices
  • Zero-Knowledge Architecture: Server cannot decrypt your data
  • Session-Based Keys: New encryption keys generated per session

For complete technical details, read our Security Whitepaper.

// troubleshooting

Performance Tips

  • Use WiFi when possible: More stable than cellular for long coding sessions
  • Keep desktop awake: Prevent computer sleep to maintain connection
  • Close unused apps: Free up mobile resources for smoother experience
  • Use external keyboard on iPad: Faster input for complex prompts
// troubleshooting

Troubleshooting Connection Issues

QR Code Not Scanning

  • Ensure camera permissions are enabled on your phone
  • Increase terminal font size to make QR code larger
  • Try better lighting or a different camera angle

Session Keeps Disconnecting

  • Keep your desktop awake and terminal window open
  • Verify stable internet connection on both devices
  • Check that your firewall isn't blocking WebSocket connections
// faq

Frequently Asked Questions

Is Termly free?

Yes, Termly is completely free to use. No credit card, no subscriptions, no hidden fees.

Does my desktop need to stay on?

Yes, your desktop runs the actual code and AI tools. Termly mirrors the session to mobile — think of it as a wireless terminal to your desktop environment.

Can I use multiple AI tools?

Yes! Termly works with Claude Code, OpenCode, GitHub Copilot, Cursor, and any terminal-based AI assistant. Switch between them by restarting with the appropriate --ai flag.

How does Termly encryption work?

Termly uses AES-256-GCM end-to-end encryption with Diffie-Hellman key exchange. Your code is encrypted on your machine before transmission and only decrypted on your mobile device. The relay server is zero-knowledge.