The opposable command

A small program for your computer that connects it to your phone. Once it's connected, Claude Code, Codex, Cursor or any other tool that speaks MCP can see the phone's screen and tap, swipe and type on it.

Install · 0.3.0-preview.1

macOS and Linux

Paste this into a terminal:

curl -fsSL https://getopposable.com/install.sh | sh

Windows

Paste this into PowerShell:

irm https://getopposable.com/install.ps1 | iex

The script picks the build for your computer, checks it against the published SHA-256 sums and puts opposable in ~/.local/bin (on Windows, %LOCALAPPDATA%\Opposable\bin, added to your PATH). It doesn't ask for an administrator password. You can read it first: install.sh, install.ps1.

Connect a phone

One code from the app

  1. In the Opposable app on your phone, tap Pair with computer. It shows a six-character code that works once, for ten minutes.
  2. On your computer, run opposable connect CODE with that code.
  3. If Claude Code is installed, the phone is added to it straight away. Otherwise the command prints what to paste into Codex, Cursor or another MCP client.

This works over the internet, so the phone doesn't need to be near the computer. You can also type the code at getopposable.com/connect instead.

Other things it does

  • opposable mcp runs a local MCP server for Android phones plugged in over USB and Android emulators. It needs adb from the Android SDK platform tools.
  • opposable doctor checks what's set up and what's missing. opposable --help lists the rest.
  • For an iPhone you need a Mac and Opposable for Mac, which comes with its own copy of this command.

Downloads

If you'd rather not run a script, download the file for your computer, unpack it (gunzip, or the zip on Windows), make it executable with chmod +x on macOS and Linux, and put it somewhere on your PATH.

Checksums: SHA256SUMS. The macOS builds are signed ad hoc but not notarized yet, which is why the script is the easy way: files fetched with curl aren't quarantined. The program includes a few open source libraries; their licenses are in NOTICES.txt and opposable --licenses.