Install the CLI

The Centrail CLI reads your local coding-agent logs and syncs usage to your dashboard. No API keys — it runs on your machine with npx, so there's nothing to install globally.

Prerequisites

Node.js 20 or newer.

Run it

npx centrail connect

The CLI prints a link and a short code. Open the link, sign in, and confirm the code before clicking Authorize. A token is saved to ~/.config/centrail/auth.json, readable only by you.

Nothing about your code is read here. The CLI only ever touches your agent's usage logs.

Keeping it current

There's nothing to upgrade in place — because you run it with npx, the version is chosen each time you invoke it. npx does cache, though, so to be sure you're on the newest build, pin @latest:

npx centrail@latest sync

Updating is also how you pick up new agents: support for Copilot CLI (and more over time) ships in the CLI, so a newer version starts syncing them automatically — no new command, no reconfiguration.

If you installed globally instead of using npx, update with:

npm install -g centrail@latest