Install the companion CLI
Install the CLI Setu companion on the computer you want to control. It needs Node.js 18 or newer on Windows, macOS or Linux.
$ npm install -g cli-setu~/how-it-works
One bridge. Two devices. Zero configuration.
A small companion on your computer, an app on your phone, and an encrypted relay in between. Here’s exactly how it fits together.
~/architecture
What happens between your desk and your pocket
Your computer
The cli-setu companion wraps your shell and your AI agent. Code and tools never leave it.
encrypted
Setu relay
Passes sealed packets between your devices. It can’t read them, and it keeps no session content.
encrypted
Your phone
Decrypts and renders the live terminal. Sends back keystrokes and approvals.
~/setup
Set up in five small steps
About three minutes, start to finish. Steps 1–3 happen only once.
Pair with a QR code
Run cli-setu pair on your computer and scan the QR code with the app. The devices exchange encryption keys directly. You only do this once.
$ cli-setu pairStart a session
Run cli-setu session in the folder you want to work in (pairing does not start a session). That terminal is now mirrored, live, on your phone.
$ cli-setu sessionRun your AI agent
Launch Claude Code, Codex CLI, Gemini CLI or any tool inside the session. Type prompts or tap to approve from your phone.
$ claude~/under-the-hood
Why it just works
Outbound connections only
Both devices dial out to the relay, the way a chat app does. That’s why there are no ports to open and it works behind any firewall or NAT.
Keys exchanged in person
The QR code carries a one-time pairing secret. Your devices use it to agree on keys that never touch our servers.
Sessions outlive the connection
If your phone loses signal, the session keeps running on the computer. Reconnect and missed output catches up.
Agent-aware parsing
The companion spots permission prompts from AI tools and sends them as structured approve/deny cards, not just text.
Text, not pixels
Terminal output is compact text, so it stays responsive on weak mobile data, unlike screen-sharing apps.
You stay in control
Unpair a computer at any time with cli-setu unpair, or remove it from the app.
Put your terminal in your pocket.
Free on Google Play. Install the companion on your computer, scan once, and your AI agents are a tap away.
On your computer
$ npm install -g cli-setuNeed a hand? Read the manual or talk to support.