Documentation

Version 1.23.0

Install

Pick the shape you want. Everything below runs the same server underneath, so you can mix them later.

Desktop app

Grab the build for your machine from the download page. On macOS you will see a Gatekeeper notice the first time because the build is not signed with an Apple certificate yet. Right-click the app, choose Open, and it will not ask again.

Terminal / browser

curl -fsSL https://shipchamber.pages.dev/install.sh | bash

The script installs the shipchamber command with whichever of npm, bun or pnpm you already have. If you would rather do it yourself:

npm i -g https://shipchamber.pages.dev/dl/web
shipchamber

Then open http://localhost:3000.

OpenCode

ShipChamber is a workspace for OpenCode. It does not bundle a model or an agent of its own. Install OpenCode first:

curl -fsSL https://opencode.ai/install | bash

Sign in to at least one provider there (opencode auth login). ShipChamber picks up the same providers and keys. If you already had OpenCode running, ShipChamber connects to it; if not, it starts one for you.

First run

1. Open ShipChamber. It asks for a project folder. Pick a repo.
2. Start a session. Type what you want done, the way you would brief a colleague.
3. Watch the diff panel on the right fill up. Every file change is reviewable before you commit.
4. Close the window whenever. The server keeps the session, and you can come back to it from any device.

Remote access

The server listens on localhost only. To reach it from another machine on your network:

shipchamber --host 0.0.0.0 --port 3000

As soon as it leaves localhost, set a UI password in Settings → Security, or pair a device. Pairing produces a one-time link (shipchamber connect-url) that the phone or browser scans; after that both sides hold a key and the password is not needed.

For access over the internet without opening a port, use Private Relay below, or put your own tunnel (Tailscale, Cloudflare Tunnel, SSH) in front and keep the password on.

Private Relay Lifetime

Relay is an encrypted rendezvous point. Your machine dials out to it; your phone dials out to it; the relay forwards bytes it cannot read. Nothing is stored and there is no inbound port on your side.

shipchamber connect-url --relay

Scan the link on your phone. From then on the phone can find the machine whether you are at home, on hotel Wi-Fi or on mobile data. Relay is part of the Lifetime plan; the CLI tells you if the key on that machine does not cover it.

Editor extension

Download the .vsix. In VS Code, Cursor, Windsurf or Trae open the Extensions view, click the ··· menu, choose Install from VSIX… and pick the file. The extension talks to the same local server, so sessions you start in the editor show up on your phone too.

License

Free is the default and needs nothing. After buying Lifetime you get a key that looks like SC-XXXX-XXXX-XXXX-XXXX. Paste it into Settings → General → License on each machine (up to five). To move a seat, deactivate on the old machine or from the same screen on a new one.

The app checks the key once a day. If you are offline it keeps working for 14 days before it asks to reconnect. Lost the key? Look it up by email.

CLI

shipchamber                      # start on port 3000
shipchamber --port 4000          # another port
shipchamber --host 0.0.0.0       # listen on the network
shipchamber connect-url          # pairing link for phone / browser
shipchamber connect-url --relay  # same, through Private Relay
shipchamber update               # update to the latest build
shipchamber --help

Config & data

Settings live in ~/.shipchamber/shipchamber.json. Sessions and history are OpenCode's and stay in its data directory. Delete those two folders and nothing of yours is left behind anywhere; there is no account and no server-side copy.