Engine documentation

input/ : drop your raw material here

Engine protocol and working reference.

Anything you drop in this folder becomes part of the brain on the next ingest run:

  • .md and .txt files: chat transcripts, notes, docs, meeting notes
  • .json files: chat exports (any vendor; text fields are extracted)

Subfolders are fine and become the "source" label in search results (for example input/support-chats/2026-01.md shows up as source support-chats).

Then run:

python3 ingest.py

or let the archiver do it on a timer (see archivers/README.md). Re-ingesting is always safe: unchanged files are skipped, changed files are updated in place, nothing is ever duplicated.