Troubleshooting
Contextify is open, but a project or conversation is missing.
Most missing-history cases come down to one of four things: no supported transcript exists yet, the app cannot read the transcript folder, the transcript is still being indexed, or you are looking at a different project identity than expected.
Fast checks
-
Confirm the session exists
Contextify indexes Claude Code and Codex CLI sessions. If you have not used one of those tools in the project yet, start a short session first.
-
Give the app a moment
New sessions are written by the assistant tool, then detected and indexed by Contextify. Very new activity may not appear instantly, and large existing histories can take longer.
-
Check app permissions
Sandboxed App Store builds need permission to read transcript folders. If the app asks for access, grant the folder it requests.
-
Search for a distinctive term
Use a file name, error string, task ID, branch name, or unusual phrase from the session. Generic searches are harder to verify.
What the symptoms usually mean
| Symptom | Likely cause | Next move |
|---|---|---|
| The app has no projects. | No supported sessions have been discovered, or transcript access is blocked. | Run Claude Code or Codex in a project, then check permissions if nothing appears. |
| A project appears, but a recent conversation is missing. | The transcript may still be writing or indexing. | Give Contextify a minute, then search for a distinctive phrase from the new session. |
| Search misses a known result. | The query may not match tokenized text, especially identifiers with punctuation. | Try fewer terms, remove punctuation, or search for a nearby phrase. |
| Cloud shows old data, but this Mac does not. | Cloud sync and local indexing are separate checks. | Verify the local app sees the project first, then inspect Cloud sync status. |
CLI checks
If the CLI is installed, it can help separate “the app UI is empty” from “the database has no indexed history.”
contextify status --json
contextify search "distinctive phrase from your session"
If contextify is not found, open Contextify Settings → CLI and use Install or Repair CLI.
For a deeper explanation of local processing, read Ingestion and syncing.
When to contact support
Contact support if you can point to a real Claude Code or Codex transcript on disk, Contextify has access to the folder, and the project still does not appear after a restart.
Include the macOS version, whether you installed the DMG or App Store build, the assistant tool you used, and any Cloud status message shown in Settings.
Last updated: May 6, 2026