> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remem.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Use Remem from terminal scripts and local automation.

# CLI

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

## Install

```bash theme={null}
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

```bash theme={null}
export REMEM_API_URL="https://api.remem.io"
export REMEM_API_KEY="vlt_your_key_here"
```

## Commands

### Fast query

```bash theme={null}
remem query "What did we decide about indexing?"
```

### Rich ask (synthesized)

```bash theme={null}
remem ask "Summarize this week's platform decisions"
```

### Fetch document by ID

```bash theme={null}
remem doc 247d51aa-0248-4c6d-b368-041383007153
```

### Health

```bash theme={null}
remem health
```

### JSON output

Add `--json` to any command:

```bash theme={null}
remem query "latest checkpoints" --mode rich --json
```

### Query with facts

Include memory layer facts in query results:

```bash theme={null}
remem query "What stack does Acme use?" --facts --entity "Acme Corp"
```

### Namespace-scoped reads

Use namespace keys with repeated `--namespace` flags:

```bash theme={null}
remem query "latest handoff" --namespace work
remem query "shared updates" --namespace work --namespace research
remem search "launch plan" --namespace '*'
```

<Note>
  Omit `--namespace` to search all namespaces your API key can read. Quote `'*'` so your shell does not expand it.
</Note>

### List entities

```bash theme={null}
remem entities
remem entities --type person --limit 20
```

### Get entity facts

```bash theme={null}
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

```bash theme={null}
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`](/session-memory), which is a separate toolkit.