syncs
View and manage sync/publish job history
Monitor sync and publish jobs. Every publish command creates one or more sync jobs that process translations and upload to CDN.
syncs list
View recent sync jobs for a project.
better-i18n syncs list -p acme/dashboard
better-i18n syncs list -p acme/dashboard --limit 20 5 recent syncs
✓ 90df897e 5/6/2026, 1:49 AM batch_publish
✓ ca9be32c 5/6/2026, 1:45 AM batch_publish
✗ 56751f79 5/5/2026, 3:35 PM sync · Upload failed
⟳ a3b489ec 5/5/2026, 3:27 PM sync
○ 04d53125 5/4/2026, 11:36 PM batch_publishOptions
| Option | Description |
|---|---|
-p, --project <org/name> | Project identifier |
--limit <n> | Number of jobs to show (default: 10) |
--json | JSON output |
syncs get
Get details about a specific sync job. Use --wait to block until the job finishes (useful right after publish).
better-i18n syncs get <syncId>
better-i18n syncs get <syncId> --wait Sync 90df897e-916e-4bec-a6a7-2d59857ac4b0
Status: completed
Type: batch_publish
Created: 5/6/2026, 1:49:45 AM
Done: 5/6/2026, 1:51:08 AMThe --wait flag blocks up to 15 seconds for the job to reach a terminal state (completed/failed/cancelled). Useful for CI scripts:
# Publish and wait for completion
RESULT=$(better-i18n publish -p acme/dashboard --json --yes)
SYNC_ID=$(echo $RESULT | jq -r '.data.syncJobIds[0]')
better-i18n syncs get $SYNC_ID --wait --jsonsyncs cancel
Cancel a sync job that hasn't started processing yet.
better-i18n syncs cancel <syncId> --yesOnly jobs in pending status can be cancelled. Once processing starts, the job runs to completion.
Options
| Option | Description |
|---|---|
--wait | Block until sync completes (max 15s) |
-y, --yes | Skip confirmation |
--json | JSON output |