README.md

Command reference

Run bin/memex --help or add bin/ to PATH. MEMEX_ROOT overrides the whole workspace root; it is useful for isolated tests. MEMEX_TZ selects an IANA timezone and defaults to UTC. MEMEX_AGENT selects the live actor for recording and session inbox context.

Command	Behavior
memex start	Session context, recording criterion, pending trail questions, inbox
memex recall "question"	Hybrid recall with source lines and provenance
memex recall "question" --full --json	Longer excerpts in structured output
memex recall "question" --no-vault	Exclude currently vault-labelled Books
memex reindex	Refresh semantic vectors; report missing embeddings
memex note BOOK TEXT --trigger T# --referent REF --question QUESTION	Automatic record with an explicit admission basis
memex note BOOK TEXT --manual --agent codex	Record explicit user-directed input
memex new projects/example --title Example --text TEXT --about memex --manual	Create a Book under schema and privacy checks
memex trail [name]	List routes or walk one
memex trail --through BOOK	Find routes reaching a Book
memex trail --orphans / --unexplained	Report route coverage and unexplained links
memex trail --sync	Refresh derived back-references in Books
memex tie TRAIL BOOK --why REASON --agreed	Append an explicitly approved trail step
memex pending	Trail proposals requiring approval
memex pending --all	Include legacy facts for agent review
memex pending --accept ID --agreed	Apply an exactly approved pending item
memex pending --drop ID	Decline a queued item
memex open	Unresolved questions and pending items
memex daily	Refresh index and propose supported trail steps; no schedule installed
memex doctor	Structural and index diagnostics; failures exit nonzero
memex scribe TRANSCRIPT --dry	Preview bounded capture without a model call or receipt
memex scribe --pending	Run bounded catch-up extraction; may incur model usage

--agreed is declared exact human assent, not an approval detector. See the writing skill for the admission rules.

Separate executables:

• dispatch: local agent inboxes, messages, and acknowledgments; protocol.
• memex-snapshot DESTINATION: consistent plaintext snapshot outside the workspace.
• library: optional browser rendering; --serve binds to loopback and vault rendering requires the optional cryptography package.

Implementation and limits: DESIGN.md.