Getting Started

Install xSwarm with npx xswarm: connect your machine in the browser, then register a project. Open Alpha.

xSwarm is in Open Alpha. Things change quickly — join the waitlist to hear about new releases.

Run this in a terminal:

npx xswarm

Setup is two steps:

1. Connect the machine. The CLI prints a short code and a URL. Open the URL in a browser where you’re already signed in and approve it — that’s the whole authentication step, no separate account creation and no password. A credential is saved to ~/.xswarm/config.json (readable only by you) so you don’t need to do this again on this machine.
2. Register a project. From inside a project’s directory, the CLI reads its name, package.json, git remote, and tech stack, and registers it under your account. You can also register every git repository under a folder at once.

Both steps can be undone: unregister a project, or log the machine out entirely. Logging out revokes the machine’s credential on the server, not just locally.

What’s next

A registered project is visible to your account, but nothing runs on it automatically yet. The on-machine daemon does the actual work — see Core Concepts for what it does once it’s running.

Requirements

• Node.js 22+
• A GitHub account, for the browser approval step