Save architectural decisions (ADRs), system patterns, task progress, and product context.
Blazing fast local full-text search in SQLite lets your AI retrieve relevant details instantly.
Export the database to clean markdown files for version control, and import them back on checkout.
Written in Rust with no background daemons, servers, memory footprint, or external APIs.
Link decisions to patterns, progress to decisions, and features to custom configuration data.
Simple JSON inputs/outputs designed for direct terminal tool execution by AI coding assistants.
$ engrams --help
Usage: engrams [OPTIONS] <COMMAND>
Commands:
init Initialize the database schema
active-context Manage the active context document
decision Log and search architectural decisions
progress Track task execution and progress
pattern Log recurring system patterns and conventions
custom Store arbitrary configuration or key-value data
link Create knowledge-graph relations between items
report Generate a structured report of project knowledge
prime Generate a context brief optimized for token budget
doctor Analyze project database for orphaned records, drift, and missing context
query Search across decisions, patterns, and custom data
anchor Manage file path anchors for decisions and patterns
relevant Find decisions and patterns relevant to path(s)
$ engrams decision log \
--summary "Use PostgreSQL for primary database" \
--rationale "Need ACID guarantees and complex queries" \
--tags "db,arch"
Decision logged as ID 1.
$ engrams decision search "caching"
# Search results retrieved instantly via FTS5 index...