Campaigns are long. Devices break, browsers get cleared, and gaming laptops have a way of dying right before a session. Today we're shipping something that covers you: Google Drive cloud sync for your vault.
Your data, your rules
Before we get into the how, here's the part that matters most: we never see your vault.
When you connect to Google Drive, Codex talks directly to Google's API from your browser. The files go from your device to your personal Drive account — there is no Codex server in the middle, no copy made on our end, no analytics on your content. Your campaign world is yours, full stop.
The OAuth token that proves you're you is held in memory only. It's never written to disk, never sent to us, and disappears the moment you close the tab. If you want to revoke access at any point, you can do it from your Google Account security settings and Codex immediately loses the ability to touch your Drive.
Your files, your Drive
When you connect a vault to Google Drive, Codex creates a CodexCryptica/ folder on your personal Drive and drops a subfolder for each vault inside it. Every push or pull goes directly between your browser and your Drive — our servers are never in the loop.
The sync is manual by design. You hit "Save to Drive" when you're ready. You hit "Load from Drive" when you want to restore. No surprise uploads mid-session, no background traffic you didn't ask for.
Differential pulls keep things fast
When you pull from Drive, Codex doesn't re-download everything. It compares what's already in your local vault against what's on Drive and only fetches files that are actually newer. A campaign with a thousand notes still pulls in seconds if only a handful changed.
Import from Drive on any device
Already backed up your vault on another machine? Open Settings → Cloud Sync, click Browse Drive, and Codex lists every vault subfolder it finds in your CodexCryptica/ folder. One click and the differential pull kicks off — you're back up to speed without copying a single file by hand.
Share a vault with your co-GM
This one came up a lot. You're running a campaign, your co-GM needs access to the same notes, and the old answer was "email them a zip file."
The new answer: share the Drive folder, send your co-GM the link, and have them paste it into the Join a Shared Vault field in Codex.
Codex fetches the folder metadata, asks Google for just enough access to read it, and pulls the vault locally. After that your co-GM can refresh their copy any time with a single "Load from Drive" click — and they never need direct access to your account.
The first join uses a slightly broader Drive scope so Codex can read a folder it didn't create. Normal push/pull for your own vaults uses the narrower drive.file scope that only touches files Codex itself made. Both tokens live in memory only and are never stored on disk.
Try it now
Head to Settings → Cloud Sync and click Connect Google Drive. The first time you connect you'll go through a standard Google OAuth flow — takes about thirty seconds.
If you run into anything, the help article has a step-by-step walkthrough.
Happy world-building.