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

Command	Description
`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 entities`	Lists memory entities
`remem entity-facts <entity_id>`	Gets facts for an entity
`remem extract-facts <document_id>`	Triggers fact extraction
`remem health`	Calls `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.

Getting Started

Using Remem

Memory Layer

Integrations

CLI

CLI

Install

Configure credentials

Commands

Fast query

Rich ask (synthesized)

Fetch document by ID

Health

JSON output

Query with facts

Namespace-scoped reads

List entities

Get entity facts

Trigger fact extraction

Command reference

Notes

​CLI

​Install

​Configure credentials

​Commands

​Fast query

​Rich ask (synthesized)

​Fetch document by ID

​Health

​JSON output

​Query with facts

​Namespace-scoped reads

​List entities

​Get entity facts

​Trigger fact extraction

​Command reference

​Notes

CLI

Install

Configure credentials

Commands

Fast query

Rich ask (synthesized)

Fetch document by ID

Health

JSON output

Query with facts

Namespace-scoped reads

List entities

Get entity facts

Trigger fact extraction

Command reference

Notes