Rather than typing facts one at a time,Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xantorres/engram/llms.txt
Use this file to discover all available pages before exploring further.
harvest and import let you populate Engram in bulk. harvest reads a saved session transcript from a supported harness — Claude Code, Codex, or OpenCode — and extracts facts that meet a minimum confidence threshold, deduplicating against what you already have. import handles the complementary case: you have a directory of Markdown notes with YAML frontmatter and want to absorb them into the memory store. Both commands stage candidates in pending status so nothing lands in recall until the review cycle runs.
harvest
Analyzes a harness session transcript (.jsonl or similar) and mines durable, high-signal facts from the conversation. Candidates are staged as pending memories and skip any that duplicate an existing entry or fall below the minimum confidence threshold.
Arguments & Options
Filesystem path to the session transcript file. The expected format depends on the selected harness. Example:
/home/user/.claude/sessions/abc123.jsonl.The agent harness that produced the transcript. Engram uses this to select the correct parser.Valid values:
claude-code, codex, opencode.Minimum confidence score
(0.0–1.0) a candidate must reach to be staged. Candidates below this threshold are counted as trivial in the summary and discarded.Short alias for
--harness.Output
A single summary line reports how many candidates were staged and why others were skipped:- dupe — the extracted fact matched an existing memory (same or very close text).
- trivial — the fact’s confidence score was below
--min-confidence.
Examples
Harvest a Claude Code session with default settings:Harvested memories are tagged with
learned_by: harvest. The doctor command will flag them as unverified until a human or agent confirms the fact via promote --confirm.import
Bulk-imports memories from a directory of Markdown files that carry YAML frontmatter. Each .md file in the target directory is parsed: the frontmatter supplies metadata (kind, confidence, etc.) and the body or a designated frontmatter field provides the fact text. Imported memories land in pending status.
Arguments & Options
Path to a directory containing
.md files with YAML frontmatter. Engram walks the directory non-recursively. Example: ./my-notes.Output
Example
Imported memories are tagged with
learned_by: imported and will appear as unverified in doctor output until they are confirmed. Use engram queue to review them before running engram sync --apply.