CLI reference

Installed as the smrititantra console script (needs the [local] extra for anything past --version). Every command that touches a store takes --org <tenant>; --database-url (or SMRITITANTRA_DATABASE_URL) picks Postgres, otherwise commands that don't need persistence (like demo) run against an in-memory store.

Run smrititantra <command> --help for a command's full flags.

Content & ingest

Command	Purpose
migrate	apply store schema migrations
author <file> --org --kind [--name]	create/revise a concept from an interchange document
import-dir <path> --org [--trust]	bulk-import an interchange tree
export-dir <path> --org	regenerate the interchange tree (backup)
import <kind> --org [--path] [--trust]	run a semantic importer (e.g. dbt)
seed-corpus <file> --org	seed P3 evidence from a question/query corpus

Sources & mining

Command	Purpose
sources add\|list\|remove	manage registered data sources
sync [source] --org [--profile]	sync sources: registry, schemas, drift
mine-workload [source] --org [--since]	mine the query log for evidence
verify-bindings --org	prove proposed/stale bindings against their sources
stale-bindings --org	the drift remap queue
mine --org [--since]	mine completed episodes into learning signals
coverage --org	the evidenced missing-concepts backlog
consolidate --org [--golden] [--no-publish]	rebuild derived views + routes, gated
eval --org --golden [--ablations] [--promote-from-episodes]	score a snapshot against a golden set
gc --org [--dry-run]	retention: prune episodes, datasets, orphaned snapshots

Recall & serving

Command	Purpose
compile --org [--no-publish]	compile and publish a recall snapshot
recall <question> --org [--mode] [--limit]	ask the memory a question
search <query> --org [--kind] [--limit]	hybrid search over concepts and assets
get <ref> --org	fetch a ref's content (ACL-trimmed)
graph project --org [--rebuild]	incremental ledger→tier projection (neo4j backend)
graph query <ref> --org [--direction] [--depth]	traverse the graph from a ref
snapshots list\|pin\|publish --org	manage compiled snapshots
demo	self-contained, in-memory ingest→compile→recall tour
serve [--host] [--port]	run the HTTP service (needs [server])
mcp [--transport]	run the MCP server (needs [server])

Curation loop

Command	Purpose
gaps list\|answer\|decline --org	knowledge gaps: list, answer, decline
reviews list\|accept\|reject --org	the curation queue

Tenancy & access

Command	Purpose
init [directory]	scaffold a tenant project (smrititantra.yaml + knowledge/)
config bootstrap\|show\|get\|set --org	tenant vocabulary config (DB-versioned)
orgs create\|list	manage organizations
agents register\|list\|quarantine\|trust --org	manage agent identities
keys issue\|revoke\|list --org	manage API keys