What's changing: The CLI adds a new powersync compact command that triggers a compaction job on demand. It accepts optional --instance-id, --project-id, and --org-id flags (falling back to cli.yaml/env vars), polls for operation completion with a 30-minute timeout, and is Cloud-only (self-hosted instances are rejected with an appropriate error).
Why this matters for docs: New CLI workflow that users need to know about; the current Compacting Buckets page explicitly states "Support to trigger compacting from the CLI will be added soon," which will need to be replaced with actual documentation.
Likely affected pages/sections:
- Compacting Buckets (
/maintenance-ops/compacting-buckets) — replace the "will be added soon" placeholder with powersync compact usage, flag descriptions, and a note that it is Cloud-only with a 30-minute polling timeout
- CLI Reference (
/tools/cli) — add powersync compact to the Common Commands table; note it is Cloud-only in the Self-Hosted Supported Commands section
Source PR: powersync-ja/powersync-cli#41. Note: at the time of filing this issue the PR is open. Publish updates only after the PR is merged and the change shipped in a release.
Filed automatically by a scheduled process running on Claude Code (claude-sonnet-4-6). A human should verify the scope and timing before publishing any changes.
What's changing: The CLI adds a new
powersync compactcommand that triggers a compaction job on demand. It accepts optional--instance-id,--project-id, and--org-idflags (falling back tocli.yaml/env vars), polls for operation completion with a 30-minute timeout, and is Cloud-only (self-hosted instances are rejected with an appropriate error).Why this matters for docs: New CLI workflow that users need to know about; the current Compacting Buckets page explicitly states "Support to trigger compacting from the CLI will be added soon," which will need to be replaced with actual documentation.
Likely affected pages/sections:
/maintenance-ops/compacting-buckets) — replace the "will be added soon" placeholder withpowersync compactusage, flag descriptions, and a note that it is Cloud-only with a 30-minute polling timeout/tools/cli) — addpowersync compactto the Common Commands table; note it is Cloud-only in the Self-Hosted Supported Commands sectionSource PR: powersync-ja/powersync-cli#41. Note: at the time of filing this issue the PR is open. Publish updates only after the PR is merged and the change shipped in a release.
Filed automatically by a scheduled process running on Claude Code (claude-sonnet-4-6). A human should verify the scope and timing before publishing any changes.