Troubleshooting

Keep completed work, use the visible retry path, and do not bypass macOS security controls.

Recon cannot find Claude Code or Codex

Open Settings > AI tools and choose Check again. Confirm the tool is installed and signed in. Recon can detect the command-line tools, the Codex app, and ChatGPT's bundled Codex. If detection still fails, choose Repair connection or use a provider key.

A source requires an AI tool or provider key

Source reading and Knowledge organization can require model-backed work. Connect one supported tool in Settings > AI tools, then retry the source. Recon should not mark onboarding complete as fully ready when no AI path is available.

Recon asks for the main project folder

Linked git worktrees are intentionally blocked from normal ingestion because they can duplicate project memory and previously caused store problems. Select the main repository checkout instead.

An update is busy, paused, or partly finished

Only one writer may update the local store at a time. Let the current ingest or maintenance run finish. Completed batches remain saved. A daily background limit can pause remaining model calls without discarding earlier work.

The source is current but Ask cannot answer

Open Knowledge and check whether organization is still pending or failed. Retry the visible Knowledge action. The original facts and receipts remain in local memory even when the concise subject view has not formed yet.

A source moved

Open Settings > Sources, remove the unavailable path, and add the new location. Removing a source does not silently delete all previously derived memory.

The app will not open after download

Confirm the DMG came from askrecon.com/download/mac. Delete the blocked copy, download it again, and compare its SHA-256 value with the public release manifest. Do not run a quarantine-removal command.

Send a useful support report

Email support@askrecon.com with the release version, macOS version, visible error, action that triggered it, and whether Retry changed anything. Never send private source files, prompts, memory text, or API keys.