iCloud Sync & Encrypted Keychain Scopes

Sync settings, plugins, API keys, and clipboard history across your Macs.

Pro, Sync & TroubleshootingCaptured interfaces · 0:08 loop

Captured client interfaces with sample data; blue outlines are guide annotations.

Key Highlights

Four Granular Sync Scopes

Independently toggle Clipboard History (macOS 14+), Extension & App Settings, Secure API Keys, and Local Plugin Packages.

End-to-End Encrypted iCloud Keychain for API Keys

API keys sync through Apple’s E2EE iCloud Keychain security group, while browser OAuth tokens intentionally stay device-local.

Local Plugin Package Sync

Custom or locally installed .swiftbiux/.swiftbiuxs extensions replicate automatically across your Macs alongside their sort order.

Smart File-Body Bandwidth Guardrails

With file-body limits enabled, a clipboard record syncs at most 5 file bodies, up to 20 MB each and 50 MB in total; the limit concerns file contents rather than rejecting the whole history record.

Custom Configuration

View all 4 custom options & thresholds
Setting / Control What it controls
iCloud Sync Master Pro toggle in General for CloudKit and iCloud Keychain synchronization across Macs.
Sync Content Sheet with 4 independent toggles: Clipboard History, Extension & App Settings, Secure API Keys, and Local Plugin Packages.
Clipboard Sync Status Live CloudKit sync indicator and manual check in Clipboard settings.
Limit File Body Sync Skips uploading oversized copied files (>20 MB single / >50 MB batch / >5 files) to CloudKit.

Settings Path & Prerequisites

  • SwiftBiu Pro license
  • Signed into the same Apple ID with iCloud Drive & iCloud Keychain enabled on each Mac (Clipboard History sync requires macOS 14+)

Troubleshooting

Expand common questions & fixes (2)

Settings synced to my second Mac, why didn’t Clipboard History sync?

Clipboard History cloud sync requires macOS 14 Sonoma or later and the Clipboard History toggle enabled inside General → Sync Content.

Why didn’t my OpenAI Codex OAuth login sync to my other Mac?

Secure API Keys syncs static API keys via E2EE iCloud Keychain, while OAuth session tokens stay local per Mac by security design.