Support

Report Issues & Request Features

We use GitHub to track bugs and feature requests:

You can also access these directly from the app via Help > Report a Bug or Help > Request a Feature.

Getting Started

Contextify automatically discovers Claude Code and Codex projects in these folders:

  • macOS: ~/.claude/projects/ and ~/.codex/sessions/
  • Windows: %USERPROFILE%\.claude\projects and %USERPROFILE%\.codex\sessions

The first launch will scan these directories and ingest conversation history. This may take a few moments depending on the number of sessions.

Common Questions

The visual-app questions in this section describe the Mac app. For the Windows tray app, see Contextify for Windows.

Click on any project tab at the top of the window, or press Cmd+Shift+P to open the Projects window.

Your local database is stored in ~/Library/Application Support/Contextify/contextify.db on macOS and %LOCALAPPDATA%\Contextify\contextify.db on Windows by default. You can choose another folder in Settings > Database.

Yes! Go to Settings > Database tab to choose a custom location. This is useful if you want to store the database on Dropbox, iCloud Drive, or an external drive.

Contextify uses lazy summarization to save battery. Entries show an hourglass icon while waiting to be summarized. Summaries are generated as you scroll to them. If you scroll away before summarization completes, it pauses until you return.

A blue arrow indicates a "directive" - a request you made for the AI to do something. Contextify tracks these so you can see when tasks were requested and completed.

This appears on messages you sent while Claude was actively working on tools. It lets you see exactly when Claude took your pending message into consideration, even during long-running operations.

Both versions are functionally identical, with a few differences:

  • DMG: Shows git status, faster performance, simpler first-run setup
  • App Store: Sandboxed (good for corporate IT compliance), automatic updates via App Store

We recommend the DMG for most developers. See Download for details.

Yes. If your original transcript files still exist in ~/.claude/projects/ and ~/.codex/sessions/, Contextify will rebuild the database from them on next launch. Only summaries would need to be regenerated.

Contextify includes a built-in transcript repair tool. If you encounter API 400 errors when resuming Claude Code Web sessions, the repair tool can detect and fix common corruption issues.

Contextify is Local-only by default. Your transcripts stay on your device. If you enable Cloud Sync, conversation entries (prompts and responses), LLM-generated summaries, and project metadata are uploaded to your Contextify Cloud account for cross-device search and backup. If you run Personal Self-Hosted, the same data flows to the server you operate instead, and no Contextify-operated server receives your transcript data. Cloud Sync is optional and can be disabled at any time. See our Privacy Policy for details.

Open the Transcripts Inventory window (Window menu) to browse all sessions across all projects. You can search, filter, and switch to any previous session.

Yes. In the Projects window (Cmd+Shift+P), right-click on a project and select "Remove Project" or use the context menu options.

Cloud Free is intended for access to the most recent 60 days of cloud conversation history. Older entries are removed from hosted-cloud availability through our retention process, which runs on a best-effort schedule rather than a fixed clock; some entries may remain searchable for a brief period beyond 60 days while retention catches up. We do not currently promise hard deletion on a fixed schedule for the Cloud Free tier; this commitment will be tightened in a future update once the retention enforcement work lands. See our Privacy Policy §5 for the canonical retention language. Cloud Pro makes cloud history available and searchable without the Cloud Free 60-day limit while the subscription remains active.

The Functional Source License, Version 1.1, Apache 2.0 Future License (FSL-1.1-Apache-2.0). The license text lives at LICENSE.md in each release of PeterPym/contextify-cloud-self-hosted. Internal organizational use, evaluation, and professional services connected to your compliant use are permitted. The license forbids Competing Use (offering substantially similar functionality to your customers as a commercial product or service). Two years after each release was made available, that release converts automatically to the Apache License 2.0. See our Terms of Service §8.4 for the canonical license clause.

The quickstart lives in the README of PeterPym/contextify-cloud-self-hosted. It walks through running the Contextify Cloud server on a Mac mini, a Linux box, or any host on a network you control (a private tailnet works well). Once your server is up, point the Mac app at it from Settings > Cloud.

You run the server. You decide where the data lives, who has access, and how long it's retained. Transcripts sync to your server. Third-party integrations like Sentry, Resend, and Tailscale are yours to turn on if you want them. See our Privacy Policy §4.3 for the full data-flow.

Two places: your configured server (for sync, auth, and search) and the app update check (website downloads only; the App Store version uses Apple's update system instead). The update check runs once a day and can be disabled from the Check for Updates menu. That's the complete list of outbound destinations on the Mac side. You can confirm on your own machine with lsof -i -P | grep Contextify or sudo tcpdump -i any host cloud.contextify.sh. For the full inventory of URL constants in the source tree, see build/docs/operations/network-behavior.md in the repository.

Send an email to support@contextify.sh with the subject "Data erasure request" and the email address on your Contextify Cloud account. While automated erasure tooling is under active development, data erasure requests are completed manually within 30 days of receipt. After erasure, your hosted-cloud transcript data, entries, and projects are removed from operational storage; backups follow a separate retention window for disaster recovery. Cloud-side erasure does not change data stored on your Mac or Windows PC. You control that data in the application. See our Privacy Policy §5 for the retention and erasure policy in full.

Contextify for Windows

Contextify installs for your Windows account in %LOCALAPPDATA%\ContextifyDesktop. Setup does not require administrator access.

Open the Contextify tray menu and choose Check for Updates…. Contextify downloads stable updates from the official GitHub releases and restarts to apply an update.

Open Settings > License, paste your license token, and choose Activate. Contextify verifies the token locally and shows the current license status in the same panel. Visit Pricing to buy or renew commercial-use rights.

Open Settings > Diagnostics. Copy Diagnostics puts the privacy-safe report on your clipboard. Contact support also copies the report, then opens a prefilled email to support@contextify.sh. If Windows cannot open an email app, the report remains on your clipboard. Contextify also shows the support address.

Open Windows Settings > Apps > Installed apps, find Contextify, and choose Uninstall. Uninstall removes the application and its owned command-line, startup, and skill integrations. It keeps your local database in %LOCALAPPDATA%\Contextify. Delete that folder separately if you also want to remove the indexed history stored by Contextify.

The default database is %LOCALAPPDATA%\Contextify\contextify.db. Contextify reads Claude Code transcripts from %USERPROFILE%\.claude\projects and Codex transcripts from %USERPROFILE%\.codex\sessions. You can choose another database folder in Settings > Database.

System Requirements

  • macOS 15 (Sequoia) or later. macOS 26 (Tahoe) required for Apple Intelligence summaries; macOS 15 runs in Lite Mode.
  • Apple Silicon (M1 or later) required for Apple Intelligence
  • Windows 11 version 21H2 or later
  • Works with Claude Code and Codex CLI

Contact

For general inquiries or private support requests:

Email: support@contextify.sh

We typically respond within 24-48 hours.