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

Contextify 1.3.0

Unified CLI Command

This release introduces contextify as the primary CLI command (replacing contextify-query).

What's New

• Unified CLI: The primary command is now contextify instead of contextify-query
• Backwards Compatibility: contextify-query and contextify-ingest still work as symlinks
• Total Recall: Updated to use the new contextify command

Installation

• DMG: Download and drag to Applications
• Homebrew: brew tap peterpym/contextify && brew install contextify-query

Migration

If you have the CLI installed via Homebrew, run:

brew update && brew upgrade contextify-query

The contextify-query command will continue to work but will show a deprecation notice when run from a terminal.

Contextify 1.2.1

macOS DMG Changes

• Improved DMG installer with directional arrow between app and Applications folder
• Fixed Applications folder icon display on macOS Tahoe (26)

Linux CLI Changes

This release improves the Linux CLI experience for fresh installations.

Bug Fixes

• Fixed argv handling - Resolved "unexpected arguments" error on launch
• Improved error messaging - Clearer output for network failures and permission issues
• Fixed signal handling - Ctrl+C during installation now cleans up properly
• Fixed progress display - Removed duplicate "Finalizing" messages

Improvements

• macOS-only flags hidden - --help on Linux no longer shows irrelevant macOS options
• Better first-run UX - Smoother ingestion flow with proper progress indication

Contextify 1.2.0

Contextify 1.2.0

What's New

Unified Linux CLI

The CLI has been refactored into a single contextify binary that handles all operations:

• contextify ingest - Index transcripts
• contextify status - Show database status
• contextify doctor - Diagnose installation
• contextify install-skill - Install Total Recall skill

Backwards-compatible symlinks (contextify-query, contextify-ingest) are included.

Quick Install (Linux):

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

Bug Fixes

• Tab persistence: Hidden project tabs now persist across app restart
• CLI argv parsing: Fixed argument parsing for Linux CLI (ct-92)

Installation

macOS (DMG)

Download Contextify-1.2.0.dmg below and drag to Applications.

Linux CLI

# Automatic installation
curl -fsSL https://contextify.sh/install.sh | sh

# Manual: download the appropriate tarball
tar xzf contextify-linux-*.tar.gz -C ~/.local/bin/

Technical Notes

• Build 20
• Schema version 34
• Requires macOS 15 (Sequoia) or later for macOS app
• macOS 26 (Tahoe) recommended for Apple Intelligence summaries

Contextify 1.1.0

Contextify v1.1.0

Highlights

All Platforms

• Linux CLI Support - Total Recall now works on Linux systems running Claude Code or Codex CLI
• Codex CLI Integration - Full skill support for OpenAI's Codex CLI alongside Claude Code
• CLI Health Checker - New contextify-query doctor command diagnoses installation issues
• 2.5x Faster Bulk Ingest - Performance optimizations dramatically speed up first-run and large history imports

macOS App

• Inline Image Rendering - Images in timeline entries now render inline with Quick Look preview
• Status Bar Permissions - Visual indicator shows permission state at a glance
• Project Attribution Fix - Entries are now correctly attributed to projects based on working directory
• Sidechain Visibility - Agent sub-conversations and tool calls are now captured and searchable

---

Full Changelog

New

• Linux CLI: contextify-query now builds and runs on Linux
• CLI Doctor Command: Run contextify-query doctor to diagnose installation health
• Codex CLI Support: Total Recall skill installs for Codex CLI automatically
• Inline Images: Timeline shows images with Quick Look support
• Status Bar Indicator: See permission status in the status bar
• Worktree Grouping: Projects visually grouped by git worktree

Improved

• Bulk Ingest Performance: ~2.5x faster via PRAGMA tuning and observation-free ingest
• Project Attribution: Entries reassigned based on CWD for accuracy
• CLI Installation: Unified manifest format, auto-repair for partial installs
• Sidechain Capture: Agent sidechains and tool invocations now stored and searchable

Fixed

• Project misattribution from session ID collisions
• Skill directory cleanup when disabling CLI integration
• PATH warning during CLI installation
• Sidechain filter now independent of "show hidden" setting

---

Installation

macOS (DMG)

Download Contextify-1.1.0.dmg below and drag to Applications.

Linux CLI

Download the appropriate tarball for your architecture:

• contextify-linux-arm64.tar.gz (ARM64/aarch64)
• contextify-linux-x86_64.tar.gz (Intel/AMD x86_64)

Extract and add to PATH:

tar xzf contextify-linux-*.tar.gz
sudo mv contextify-query /usr/local/bin/

Homebrew (macOS CLI only)

brew tap peterpym/contextify
brew install contextify-query

Contextify 1.0.7

What's New

• Total Recall: Your AI can now search your conversation history with /total-recall
• Improved skill discoverability with autocomplete support
• Updated system requirements display on download page

Download

Download the DMG and drag Contextify to Applications. Existing users will receive this update automatically via Sparkle.

CLI Users (Homebrew): Run brew upgrade contextify-query after the formula is updated.

Contextify 1.0.6

What's New

• macOS 15 Compatibility - Now supports macOS 15 (Sequoia) in Lite Mode. Timeline monitoring and search work fully; AI summaries require macOS 26+.

• Total Recall - Introducing Contextify Query, a new CLI for AI to query your conversation history using a new Claude Code skill and Agent. See Settings > CLI for install instructions.

• Improved Agent Sidechain Support - Better capture of tool invocations and agent sidechains for more complete conversation context.

• Bug Fixes and Performance Enhancements

CLI v1.0.5

Fix: Handle argv[0] without path (occurs when invoked by command name only)