OpenCodeTutorialMobileSetupOpen Source

How to Use OpenCode on Your Phone: Complete Setup Guide

T
Termly Team
Engineering
5 min read
Share:

OpenCode is an open-source AI coding agent built for the terminal, with over 95K GitHub stars and a passionate developer community. With Termly, you can now access your OpenCode sessions from your iPhone or Android device.

Why OpenCode on Mobile?

OpenCode stands out from other AI coding tools for several reasons:

  • Open source — Fully transparent, community-driven development
  • 75+ model support — Works with Claude, GPT, Gemini, local models, and more
  • Dual agents — Dedicated build and plan agents for different tasks
  • LSP integration — Language Server Protocol support for smarter code understanding
  • MCP support — Model Context Protocol for extended tool use

Adding mobile access with Termly means you can monitor builds, review suggestions, and send prompts from anywhere.

Prerequisites

Before starting, make sure you have:

  • OpenCode installed on your desktop:
    curl -fsSL https://opencode.ai/install | bash
    
    Or via npm:
    npm i -g opencode
    
  • Node.js 18 or later
  • Termly CLI installed
  • An iPhone (iOS 15+) or Android device

Step 1: Install Termly CLI

Open your terminal and install the Termly CLI globally:

npm install -g @termly-dev/cli

This installs the termly command that bridges your desktop OpenCode session to mobile.

Step 2: Launch OpenCode via Termly

Navigate to your project directory and start OpenCode through Termly:

cd /path/to/your/project
termly start --ai opencode

Or let Termly auto-detect OpenCode:

termly start

A QR code will appear in your terminal within seconds.

Step 3: Connect Your Mobile Device

  1. Download the Termly app from the App Store or Google Play
  2. Open the app and tap "+" or "New Session"
  3. Scan the QR code displayed in your terminal
  4. Your OpenCode session appears instantly on your phone

That's it! You're now running OpenCode on mobile.

Security: End-to-End Encrypted

Termly uses end-to-end encryption with AES-256-GCM and Diffie-Hellman key exchange. Your code never touches our servers in unencrypted form.

  1. Desktop encrypts — Your machine encrypts all data before sending
  2. Server relays — Termly's backend acts as a zero-knowledge relay (we can't read your data)
  3. Mobile decrypts — Your phone decrypts and displays the session

Your proprietary code stays private, always.

Pro Tips for Mobile OpenCode

Use Voice Input

Tap the microphone icon in Termly to dictate prompts. Describe features, request refactoring, or ask questions about your codebase — all hands-free.

Switch Between Build and Plan Agents

OpenCode's dual-agent system (build and plan) works seamlessly through Termly. Use Tab to switch between agents on your desktop, and see the results in real time on mobile.

Review AI Suggestions on Mobile

When OpenCode generates code changes, review them on your phone before accepting. The mobile interface makes it easy to scroll through diffs and suggestions.

Leverage 75+ Models

OpenCode supports Claude, GPT, Gemini, Llama, and local models. Switch models as needed — Termly relays everything transparently regardless of which model you're using.

Troubleshooting

QR Code Not Scanning?

  • Ensure your phone's camera has permission to access the camera
  • Try increasing terminal font size to make QR code larger
  • Check that both devices have internet access

Session Disconnecting?

  • Keep your desktop awake and the terminal window open
  • Check your internet connection stability
  • Verify firewall isn't blocking WebSocket connections

Can't See OpenCode's Responses?

  • Ensure you're running the latest version of Termly CLI: npm update -g @termly-dev/cli
  • Restart the session with termly start --ai opencode

Conclusion

OpenCode is one of the most powerful open-source AI coding agents available, and with Termly, you can take it with you everywhere. Whether you're reviewing code on the train, sending prompts from a coffee shop, or monitoring a build from the couch — your OpenCode workflow stays with you.

Try it today:

Questions? Join our Discord community or email us at hello@termly.dev.

T
Written by
Termly Team
Engineering
Share:
Termly - Universal AI Coding Assistant on Mobile