Sources and updates

Sources define what Recon may read. Adding a folder is not permission to read the rest of your Mac.

Supported material

Recon can read source code and common work documents, including Markdown, text, JSON, CSV, PDF, and DOCX. Very large or unsupported files may be skipped or bounded.

What Recon skips

Recon excludes common dependency folders, generated build output, secret-looking files, and unsupported formats. It does not treat raw Claude transcript JSONL as a normal source folder. Historical transcript import needs a bounded, explicit importer so private conversation data is not swept in accidentally.

What an update does

An update reads changed material in bounded batches, saves completed facts and receipts, connects related memory, and queues Knowledge organization. Work already saved remains available if a later model call is paused or fails.

Use Settings > Sources to:

• add a project, folder, or selected documents
• see update progress and errors
• update a source now
• pause, retry, or remove a source

Removing a source stops future reads. Existing derived memory remains until you explicitly remove the local data associated with it.

Keeping a project current

Choose Update now after meaningful file changes. If you opt in, local git hooks can refresh changed files after pull, merge, or rebase. Recon never installs persistent hooks without your action.

Do not start a second ingest while the app or another Recon process is updating the local store. If Recon reports that memory is busy, let the current operation finish and retry.