Getting Started

How It Works

Btelo Coding runs an agent on the computer you want to control, and you reach it from a client — the desktop app, your iPhone, or your iPad.

The easiest way to run the agent is the desktop app: a real Mac or Windows application with everything built in. Download it, double-click, and a guided setup gets you coding. No terminal, no install scripts, no commands to copy.

The desktop app covers Mac and Windows. On Linux there is no desktop app — use the CLI agent instead.

Mac & Windows: Desktop App

1. Download the app for your platform from the download page:
   • macOS (Apple Silicon) — Btelo-Coding-darwin-arm64.dmg
   • macOS (Intel) — Btelo-Coding-darwin-amd64.dmg
   • Windows (x64) — btelo-coding-app-windows-amd64.exe
   • Windows (ARM64) — btelo-coding-app-windows-arm64.exe
2. Open the app. A short welcome guide walks you through picking a language and setting up a coding agent (Claude Code or Codex).
3. Click Start coding. Chat with the AI right in the desktop window — no phone required.

That's the whole setup. See the Desktop App guide for the full walkthrough, the built-in Btelo Agent, and settings.

Connect Your iPhone (optional)

Want to drive this computer from your phone?

1. In the desktop app, open the Connect panel — it shows a pairing QR code.
2. Install Btelo Coding from the App Store on your iPhone or iPad.
3. In the iOS app, tap + (Add Connector) and scan the QR code.
4. Start chatting — sessions stay in sync between your computer and phone.

See the iOS App guide for more.

Linux: CLI Agent

There is no desktop app for Linux. Run the lightweight CLI agent instead:

curl -fsSL https://coding.btelo.com/install.sh | sh
vibe-remote

Full instructions, TUI shortcuts, and headless mode are on the CLI Agent page.

Update

The desktop app updates itself — open Settings → Check for updates, or let it prompt you when a new version ships. For the CLI agent, run vibe-remote update.