Connect & sync

Sync your usage

npx centrail sync

This scans for new events and pushes them. Re-run it anytime — only new events are sent. To re-scan your full history:

npx centrail sync --full

How far back does it sync?

There's no time window. A normal sync sends everything new since your last sync; sync --full re-scans your entire local history. Re-sending is always safe — the server de-duplicates, so an overlap never double-counts.

The watermark that tracks "your last sync" is shared across every agent. That has one consequence worth knowing: when a new agent becomes supported (say you've synced Claude Code for weeks and Copilot CLI support arrives), a normal sync treats that new agent as already caught up to the watermark and won't reach back for its older sessions. Run npx centrail sync --full once to backfill them.

The real limit on how far back you can go is how long each tool keeps its own local logs — Claude Code under ~/.claude/projects (or ~/.config/claude, or CLAUDE_CONFIG_DIR), Copilot CLI under ~/.copilot/session-state. Once an agent rotates or deletes an old session, it's gone from your disk and there's nothing left to read.

Troubleshooting

• "Token revoked or expired" — run npx centrail connect again. You can revoke a machine anytime from your Profile.
• "No agent usage found" — there's no usage to sync yet. Use a coding agent (Claude Code or Copilot CLI), then run sync.