Skip to main content

​
CLI

Remem provides a lightweight CLI package (remem-cli) backed by remem-client.

​
Install

python -m pip install "remem-cli @ git+https://github.com/asimgilani/remem.git@master#subdirectory=packages/remem-cli"
The client dependency is installed automatically.

​
Configure credentials

export REMEM_API_URL="https://api.remem.io"
export REMEM_API_KEY="vlt_your_key_here"

​
Commands

​
Fast query

remem query "What did we decide about indexing?"

​
Rich ask (synthesized)

remem ask "Summarize this week's platform decisions"

​
Fetch document by ID

remem doc 247d51aa-0248-4c6d-b368-041383007153

​
Health

remem health

​
JSON output

Add --json to any command: 
remem query "latest checkpoints" --mode rich --json

​
Query with facts

Include memory layer facts in query results: 
remem query "What stack does Acme use?" --facts --entity "Acme Corp"

​
Namespace-scoped reads

Use namespace keys with repeated --namespace flags: 
remem query "latest handoff" --namespace work
remem query "shared updates" --namespace work --namespace research
remem search "launch plan" --namespace '*'
Omit --namespace to search all namespaces your API key can read. Quote '*' so your shell does not expand it.

​
List entities

remem entities
remem entities --type person --limit 20

​
Get entity facts

remem entity-facts ENTITY_UUID
remem entity-facts ENTITY_UUID --fact-type preference
remem entity-facts ENTITY_UUID --all-versions  # include superseded facts

​
Trigger fact extraction

remem extract-facts DOCUMENT_UUID

​
Command reference

CommandDescription
remem query <text>Calls POST /v1/query
remem search <text>Calls GET /v1/search
remem ask <question>Calls rich mode with synthesis
remem doc <document_id>Calls GET /v1/documents/{id}
remem entitiesLists memory entities
remem entity-facts <entity_id>Gets facts for an entity
remem extract-facts <document_id>Triggers fact extraction
remem healthCalls GET /health

​
Notes

  • Auth is sent as Authorization: Bearer vlt_....
  • Query and search commands support namespace keys via --namespace.
  • For coding-session automation (checkpoint/rollup wrappers), use remem-dev-sessions, which is a separate toolkit.