Core Concepts

Sync & Cloud

Contxt stores memory locally by default. Sync pushes your context to the cloud so it's available across machines, teams, and the web dashboard.

Push to cloud

Push all local entries that haven't been synced yet:

contxt sync push

Only new or updated entries are transferred. Already-synced entries are skipped.

Pull from cloud

Pull remote entries to your local database (useful when switching machines or joining a shared project):

contxt sync pull

Bidirectional sync

contxt sync

Runs pull then push in sequence. Safe to run frequently.

Flags

FlagDescription
--dry-runShow what would be synced without making changes
--forceOverride conflict detection and push all local entries

Automatic sync via git hooks

If you initialized your project with contxt init, git hooks are already installed — no extra setup needed. The post-commit and pre-push hooks silently push new entries to the cloud on every commit and push.

If hooks were removed or you need to reinstall them manually:

contxt hook install # re-install if removed

See the contxt hook reference for the full list of installed hooks and configuration options.