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.