Cloud sync

Access your complete and unified AI coding history from any machine.

Contextify Cloud syncs your indexed Claude Code and Codex history between your machines, so work you did on one Mac is searchable from another.

Connect in 3 steps

Before you start: these steps use the Contextify Mac app, so install and open it first (see the Mac quickstart). On Linux, you connect to Cloud from the terminal with contextify cloud setup instead, see the Linux guide.

  1. Open Settings → Cloud

    Choose hosted Contextify Cloud and click Connect this Mac.

    Running your own server instead? Follow the self-hosted quickstart.

  2. Sign in

    Enter the email you want for Contextify Cloud and finish the browser handoff. If your account or workspace does not exist yet, verification creates it.

  3. Let the app save this device

    Once sign-in succeeds, the app stores a device credential for this Mac. The hosted flow never asks you to paste an API key by hand.

Confirm it is syncing

Open the Cloud tab. It shows the provider, the connected device, your account, and the current sync state.

A Mac with a large local history indexes that history first, so Cloud sync can show a deferred state until the local pass finishes. See Ingestion and syncing if the first run takes a while.

What syncs and what does not

Sync uploads the AI history Contextify has already indexed on this Mac and pulls down matching updates from your other machines. It reads from your local history; it is not a server-to-server transfer.

Syncs to your account: projects, conversations, and transcript entries Contextify has indexed on this Mac, plus the device metadata that ties them together.

Stays on this Mac: anything Contextify has not indexed, projects you left out of sync, and your account, membership, billing, and API keys.

Switching between hosted and self-hosted leaves the old service untouched. The cloud switching guide lists exactly what moves.

Troubleshooting

Sync stuck, or the status reads offline? Start with Cloud sync troubleshooting, which walks through the status states and the hosted and self-hosted checks.

Last updated: May 31, 2026