Contextify 1.6.2

Contextify 1.6.2

Contextify 1.6.2 is live on the Mac App Store and available as a direct Mac download.

Downloads

• Mac DMG: Contextify.dmg
• Linux CLI: contextify-linux-x86_64.tar.gz and contextify-linux-arm64.tar.gz

The Mac DMG is signed, notarized, and stapled. The Linux archives include the contextify, contextify-query, and contextify-ingest command-line tools plus the Total Recall skill.

v1.7.3

What's New in 1.7.3

Fixes

• Fixed an unexpected macOS permission prompt.

v1.7.2

What's New in 1.7.2

Privacy and Telemetry

• Contextify 1.7.2 adds optional usage telemetry for the Mac app and CLI, off by default.
• When enabled, telemetry sends a short, fixed set of activation events so development effort can go toward what helps users get started.
• Telemetry never includes conversation content, prompts, responses, file paths, project names, or search query text.
• Telemetry is off entirely when Contextify is set up as Personal Self-Hosted.
• Existing users get a one-time opt-in prompt before any telemetry is enabled.

Reliability and Stability

• Cross-platform ingest correctness is hardened for databases shared across macOS and Linux.
• Database identity handling is stricter for sessionful path identities.
• Bookmark storage preserves unreadable bookmark files instead of overwriting them.
• Bookmark metadata decoding accepts the date format Contextify writes.
• The CLI refuses future-schema databases instead of attempting a risky migration.
• Linux CLI telemetry commands honor JSON output consistently.

Contextify 1.7.1

Contextify 1.7.1

Added

• New skills for real-time session monitoring via Live Recall. See the Live Recall docs.
• contextify status and contextify doctor expose ingester health for use in automation.

Changed

• Search is now exposed with Command-F, with a suggestion to use /total-recall for best results.
• Light pass toward updating the app UI to conform to newer macOS design.

Fixed

• Fixed a regression so Cmd+W closes the window instead of quitting the app.

Contextify 1.7.0

Contextify 1.7.0

Total Recall can now search your whole team's history, not just your own, right from the command line.

Team-aware Total Recall

When your team shares project history through Contextify Cloud, contextify search returns your teammates' matching sessions alongside your own, and the Total Recall skill surfaces them inside your current session. Every result names whose session it came from. Add --mine to limit a search to just your own context.

You choose what to share

contextify cloud share myproject shares one project's history with your team; --off stops it. Sharing is per project and you turn it on yourself. Works the same in the Mac app and the Linux CLI.

Live Recall: follow sessions as they happen

contextify watch "your query" blocks until a new entry matches, contextify tail streams each new event as one line, and contextify since <cursor> returns everything after a point you mark.

Also in 1.7.0

• Full-text search no longer hangs on large databases
• Team search keeps going when one shared project can't be reached

If you're upgrading: the team-aware skill ships inside the app, so it arrives once you update Contextify and re-run contextify install-plugin.

Full notes: https://contextify.sh/release-notes/1.7.0.html

v1.6.1

Contextify 1.6.1

A reliability fast-follow to 1.6.0, focused on cloud sync and startup.

Fixes

• Catch-up sync finishes. Large catch-up uploads no longer wedge at 100%, and the synced-entries counter advances correctly while the upload runs.
• The timeline renders on cold launch. Startup project activation is now single-flighted and the timeline retries on a lost race instead of aborting, so the occasional blank timeline on a fresh launch is resolved.
• Startup and ingestion hardening. Project watchers and events key on the database project id, bulk ingestion rolls back cleanly on a mid-batch error, and several startup-path edge cases are fixed.

Install

• macOS: download Contextify.dmg below, or let Sparkle update the app in place.
• Linux CLI: contextify-linux-arm64.tar.gz or contextify-linux-x86_64.tar.gz below.
• Homebrew: brew upgrade contextify-query.

Build 31. Verify any download against the .sha256 published beside it.

Contextify 1.6.0

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

Contextify 1.5.0

Contextify Cloud

Contextify Cloud is here. Push your conversation database to the cloud and search it from any device. Per-project sync controls let you choose exactly what gets synced. 14-day free trial, no credit card required.

• Cloud sync with progress tracking and ETA estimation
• Per-project opt-in/out controls for privacy
• Team management with seat-based billing
• CLI cloud push, cloud pull, and cloud status commands
• Device provenance tracking across machines

Search Quality

• Porter stemming for better natural-language matching ("deploy" finds "deployed", "deployment")
• Git-anchored search: find conversations by the files they touched (--anchor-files)
• FTS5 hyphen pre-processing for queries like "pre-commit" and "e2e"
• Improved handling of parentheses and unbalanced quotes

CLI Improvements

• --hours, --since, --until time filtering
• Short UUID prefixes for entry and context commands (8 characters)
• Fuzzy project name suggestions on typo
• Search scope summary showing entry, project, and device counts
• Data freshness indicator in status output
• Cloud commands available from the macOS CLI

New Features

• Menu bar mode with background utility operation
• Launch at Login support (DMG and App Store)
• Transcript tagging for excluding benchmarks from search
• Sidechain transcript discovery (subagents/)
• Proof-of-concept Gemini CLI and OpenCode transcript format support

Reliability

• Cloud sync chunks large queries to stay under SQLite's 999-parameter limit
• Automatic retry on transient 502/503/504 server errors
• Graceful deferral when ingest is in progress
• Settings window stays above main window with Keep on Top enabled

Installation

macOS App (DMG): Download Contextify.dmg below

macOS CLI (Homebrew):

brew install PeterPym/contextify/contextify-query

macOS CLI (manual):

curl -fsSL https://contextify.sh/install.sh | sh

Linux CLI:

# arm64
curl -fsSL https://github.com/PeterPym/contextify/releases/download/v1.5.0/contextify-linux-arm64.tar.gz | tar xz -C /usr/local/bin

# x86_64
curl -fsSL https://github.com/PeterPym/contextify/releases/download/v1.5.0/contextify-linux-x86_64.tar.gz | tar xz -C /usr/local/bin

Full changelog

v1.3.2...v1.5.0

Contextify 1.3.2

Performance Hotfix

Fixes a critical performance regression in CLI search that caused queries with multiple OR terms to hang for minutes.

What changed

• searchTermCounts is now opt-in via --term-counts flag (previously ran automatically on every search)
• Fixed query plan inversion where SQLite chose a catastrophic scan path instead of using the FTS index
• Optimized searchCount with an FTS-only COUNT fast path

Performance improvement

• Cold cache: 74s → 0.87s (85x faster)
• Raw SQL: 64s → 7ms (9,100x faster)

Full changelog

v1.3.1...v1.3.2

Contextify 1.3.1

What's New

Always-on-Top Window

Keep Contextify floating above other windows via Window > Float on Top. Stay in the loop while coding without switching windows.

Total Recall Skill Improvements

• JSON schema documentation for AI-parseable responses
• Query expansion and intent classification
• New search options: --offset, --snippet-tokens, --count-only
• Per-term counts for OR search queries

CLI Improvements

• contextify is now the primary command (replaces contextify-query)
• Graceful SIGINT handling with progress display
• O(n) syscall bottleneck removed in project discovery

Installation

• DMG: Download and drag to Applications
• Homebrew: brew tap peterpym/contextify && brew install contextify-query
• Linux: Download tarball from this release