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:

  • ~/.claude/projects/
  • ~/.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

How do I change the active project?

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

Where is my data stored?

All data is stored locally in ~/Library/Application Support/Contextify/contextify.db by default. You can change this location in Settings > Database tab.

Can I use a custom database location?

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.

Why do some entries show an hourglass?

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.

What do the blue arrows mean?

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.

What does the orange "QUEUED" badge mean?

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.

What's the difference between App Store and DMG?

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.

Is it safe to delete the database?

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.

How do I repair a corrupted transcript?

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.

Does Contextify send data to the cloud?

Contextify is Local-only by default. Your transcripts stay on your Mac. 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.

How do I view older sessions?

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

Can I delete a project?

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

Why is my Cloud Free history beyond 60 days still appearing in search?

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.

What license does Personal Self-Hosted use?

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.

How do I get started with Personal Self-Hosted?

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.

What's different about Self-Hosted privacy?

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.

Where does the Mac app send data in Personal Self-Hosted mode?

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.

How do I request deletion of my Cloud Free or Cloud Pro data?

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. Local data on your Mac is never affected by a cloud-side erasure request; you control local data directly through the macOS application. See our Privacy Policy §5 for the retention and erasure policy in full.

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
  • 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.