Getting Started

Installation

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

This installs the cinch binary to /usr/local/bin.

Verify the install:

cinch version

Authenticate

Sign in to your Cinch account (or create one):

cinch auth login

This opens a browser window. Sign in with GitHub or Google — once complete, the terminal confirms:

✓ Signed in. Proceeding...

To use a self-hosted relay instead of the hosted service:

cinch auth login --relay https://your-relay.example.com

Quick start

Push

Pipe any command’s output to the relay:

echo "hello from $(hostname)" | cinch push

Pull

On another machine:

cinch pull
# → hello from my-server

Pair a remote machine

To set up cinch on a remote server in one command — SSH in, install, and pair automatically:

cinch pair user@remotehost

This regenerates a pair token, SSHes in, installs cinch if needed, and pairs the machine with your account. No manual steps on the remote end.

For automatic clipboard receiving on macOS, install the desktop app.