>_

Docs

Get started with Twing

Twing's coordination layer runs today as an open CLI and a self-hostable coordination server. This is the quick path to your first repo running with it; the CLI's own README has full detail.

1. Install the CLI

npm install -g @twing/cli

Published on npm, works on macOS, Linux, and Windows.

2. Connect a repo

cd your-repo
twing init

This installs the local capture hook, wires it into Claude Code, starts the background daemon, and connects the repo to a coordination server. Point it at a specific server with twing init --server <url> the first time; after that it's read from the repo's own committed config.

3. See what agents are doing

twing align

Reports cross-session divergence — places where more than one agent session has touched the same code, so you can catch it before it surfaces as a conflict.

4. Run your own coordination server (optional)

Twing's coordination server is self-hostable. Use a hosted coordinator, or run your own — see the CLI README for the full setup, including single-developer no-auth mode and multi-team access control.