@implicit-ai/relay

Control Claude Code from your phone with Implicit.

The relay is a CLI that runs on your laptop. It bridges your phone (the Implicit iOS app) to Claude Code: the phone sends prompts, the relay runs them on your laptop in a project directory, and streams output, tool calls, and permission requests back to your phone.

Install

npm install -g @implicit-ai/relay

Requires Node 18+.

Quick start

implicit connect

On first run, a browser opens to sign in with the same account you used in the Implicit iOS app. After that, implicit connect keeps a long-lived connection open and your phone can send prompts.

Sessions run on your laptop, in the working directory you point at. Your laptop must be on and connected for the iOS app to do anything.

Commands

| Command | Purpose | |---|---| | implicit connect | Pair (first run) and keep the relay open. Default command. | | implicit login | Re-pair without starting the relay. | | implicit logout | Clear stored credentials. | | implicit status | Show current connection state. |

Working directory

Each session runs in one directory on your laptop. The relay resolves it in this order:

1. --cwd <path> flag passed to implicit connect
2. defaultCwd in ~/.implicit/config.json
3. $HOME (fallback)

Override per-run:

implicit connect --cwd ~/code/my-project

The resolved path is logged when connect starts and on every incoming session.

Environments

implicit connect --env development   # default — Implicit dev gateway
implicit connect --env production    # Implicit prod gateway

Privacy

The relay stores its auth token locally (macOS Keychain on Mac). It connects only to Implicit's gateway over WebSocket/Ably and the Claude Code Agent SDK on your machine. No telemetry.

Developing on a branch

When iterating on relay changes locally (e.g. testing a feature branch before publishing), build and link the package so implicit connect runs your branch instead of the published version:

cd packages/relay
npm install
npm run build
npm link    # exposes the global `implicit` bin from this checkout

Verify with which implicit and implicit --version. Revert with npm uninstall -g @implicit-ai/relay && npm install -g @implicit-ai/relay.

License

MIT