Help / Getting started
Getting started
Install Recon Local, add a source, connect an AI tool, and verify the first answer.
You can use the Mac app without Terminal. Start with one small, useful source so the first result is easy to inspect.
Requirements
- Apple Silicon Mac
- macOS 12 or later
- Claude Code, Codex, the Codex app, ChatGPT with bundled Codex, or a supported provider API key for model-backed work
Install the app
- Download the current release from askrecon.com/download/mac.
- Open the DMG and drag Recon into Applications.
- Launch Recon from Applications, not from inside the DMG.
- Complete the privacy and AI-tool checks in onboarding.
The public build is Developer ID signed, notarized by Apple, and stapled. Do not remove quarantine attributes or bypass Gatekeeper in Terminal. If macOS blocks a copy, download it again from the first-party link and follow Troubleshooting.
Add the first source
Choose one project, folder, or small set of documents. Recon shows the exact boundary before you confirm it. It skips common dependencies, generated output, secret-looking files, and unsupported formats.
During the first update, Recon saves completed work as it goes. A long source does not need to finish every global maintenance step before useful memory can appear.
Connect an AI tool
Open Settings > AI tools. Automatic mode uses an available signed-in Claude Code or Codex installation. If nothing is ready, install and sign in to one supported tool or add a provider key, then select Check again.
Choose Repair connection if the tool is present but its Recon guidance or local memory tools are missing.
Verify the result
Ask one question about work that actually exists in the selected source, for example:
Why did we keep the first release local instead of hosted-only?
A useful answer should state the decision, explain the relevant constraint, and offer receipts. Open a receipt and verify that it points to material you selected.
If the source update completed but the answer is still missing, see Troubleshooting.