Skip to content

v1.6.0

Choose a tag to compare

@banagale banagale released this 08 Jun 23:21
· 1 commit to main since this release

Contextify Cloud

Contextify Cloud syncs your Claude Code and Codex conversation history across every computer you own. v1.6.0 ships two ways to run it:

  • Personal Self-Hosted. Free, source-available under the Functional Source License (FSL-1.1-Apache-2.0). You run the cloud software on your own server. The server can be a Mac mini, NUC, or any Linux box on a home network or a Tailscale private network (tailnet). Your conversation history stays on hardware you control.
  • Contextify Cloud (hosted). Your AI remembers everything across every Mac or Linux machine you own. The Total Recall skill pulls past decisions and solutions from any of them, automatically. Magic-link sign-in. 14-day free trial, no credit card required.

Local Commercial License

Contextify is free for personal use. A new Local Commercial license covers using the local app at work: $8 per month or $77 per year for one person, on every Mac and Linux machine you use.

  • Activate, check, or remove a license in Settings > License
  • contextify license activate, status, and remove in both the macOS and Linux CLIs
  • One license per person, across the macOS app and the Linux CLI
  • The app stays fully functional without a license; activation records your commercial-use right and never gates a feature

In-App Cloud Sign-In

  • In-app device flow modal replaces the prior Terminal handoff
  • Magic-link auto-account-creation on first use
  • Provider-aware connection sheet for hosted and self-hosted targets
  • Cloud Settings shows the active server URL when running self-hosted

Personal Self-Hosted Setup

  • Docker Compose deployment with docker-compose.selfhosted.yml
  • First-admin bootstrap via CLI (contextify-cloud create-admin) plus token-gated /setup that auto-locks after first use
  • contextify-cloud backup, restore, and update subcommands
  • macOS app and Linux CLI connect to a custom server URL from Cloud Settings
  • Operator-runnable network-behavior verification in build/docs/operations/network-behavior.md

Cloud Sync Reliability

  • Chunked content transport so large entries push reliably
  • Push batches capped by payload size and item count
  • Catch-up progress bar, numerator, and percent aligned to a single entries-based fraction
  • Push progress visually distinguished from pull
  • Cursors reset when the server target changes
  • Pushes clamp to the retention window
  • Heavier database queries deferred off the main thread

Cloud Settings

  • Skipped-entries count, retry control, and diagnostics surface
  • Warmer benefit-first empty state with "Connect this Mac" call-to-action
  • Open the Cloud Activity dashboard through a browser handoff from settings

Sign-In Fixes

  • Sanitized HTTP error responses; raw server bodies no longer echoed
  • Silent auto-retry on transient 502, 503, 504
  • Verification URLs restricted to http and https schemes
  • Duplicate error rendering removed; empty instruction rows hidden
  • Consume verification_uri_complete when the server provides it
  • Provider switch clarifies account replacement and hides API key links for invalid targets
  • Self-hosted target preserved across the sign-in flow
  • Self-hosted connection failures get a clearer message

MCP Server (New)

contextify serve-mcp is an additional way to give your AI access to your conversation history. The Total Recall skill (Claude Code, Codex) and the companion CLI already cover the primary integrations; the MCP server adds compatibility with any Model Context Protocol client.

  • Read-only tool surface: search, list recent, fetch entry
  • Bound context_size with anchor-preserving trim
  • Strict numeric-argument and mode-flag validation

Codex Integration

  • Codex plugin marketplace package
  • Native contextify-researcher TOML subagent with dual-path skill install
  • contextify doctor validates Codex plugin cache, agent registration, and runtime visibility

Under the Hood

  • Reload sync config before a manual retry
  • Avoid Cloud URLSession stalls; package builds restored to zero warnings
  • MCP server: prevent integer overflow crash; harden malformed-argument handling

Full Changelog

v1.5.0...v1.6.0