Skip to main content
Tuple’s CLI is considered alpha. Aspects of the feature might change as we continue to iterate on feedback.
The tuple CLI is a command-line tool that controls a running Tuple desktop app. You can use it to start and join calls, manage contacts, capture the shared screen, stream transcriptions, search transcripts of past calls, post notifications into a call, and run an MCP server so AI coding agents can drive Tuple on your behalf.The CLI talks to the desktop app over a local socket - there’s no network call to Tuple’s servers. The app must be running and signed in for commands to work.

​
Installing the CLI

The tuple binary ships inside the Tuple app bundle. To make it available on your PATH:
  1. Open Settings → Integrations (or press cmd + , and select the Integrations tab).
  2. Select CLI Server from the integrations list.
  3. Click Install CLI.
Tuple symlinks the bundled binary into /usr/local/bin/tuple. If /usr/local/bin is not writable by your user, Tuple prompts for your administrator password.Once installed, run tuple --help from any terminal to see the full command tree.

​
Authorizing the CLI

Tuple gates access behind an explicit authorization decision. Right after you click Install CLI, Tuple makes a harmless probe through the newly installed binary so the authorization prompt appears while you’re still in the install flow. If that probe doesn’t run for any reason, the prompt will instead appear the first time you run a tuple command from your terminal.Your choice is stored in the macOS Keychain. You can revoke or re-grant access at any time from Settings → Integrations → CLI Server. Revoking takes effect immediately - any CLI command running at the time will stop.
While authorization is unset, individual tuple commands wait for your decision rather than failing. If you dismiss the prompt without choosing, the request stays parked until you make a decision or quit Tuple.

​
Configuration file

The CLI stores user-level preferences — your default harness for tuple connect, custom harness definitions, per-harness launch settings, and which agents you’ve already been offered tuple mcp install for — in ~/.tuple/cli.toml.
The file is created on first write with permissions 0600 (parent directory 0700). A missing file is not an error — the CLI falls back to built-in defaults. Example contents after picking Claude Code as your default harness and saving a model override:

​
What’s next