API Tokens
Tokens let the sdi CLI trigger syncs and read progress on your behalf.
Token created
Copy it now — this is the only time it will be shown.
Log the CLI in with:
Paste the token when prompted — it is not echoed, and stays out of your shell history.
For CI, pipe it instead: … | sdi login <url> --token-stdin
Generate a new token
Active tokens
Loading...
Using the CLI
npm install -g sync-docker-image-cli
sdi login https://example.vercel.app
sdi copy nginx:1.27 --wait # sync one tag, block until done
sdi sync nginx # sync every tag
sdi list --status failed # recent jobs
sdi status <job-id> --wait # step-by-step progress
sdi copy redis:7 --wait --json # machine-readable output
For scripts and agents: pass --json, and branch on the exit code —
0 success,
3 sync failed,
4 timed out.