Installation

Get deja running locally in under a minute.

Requirements

deja requires Python 3.9+. It runs on macOS, Linux, and Windows (WSL). No other dependencies needed.

Install via pip

bash

pip install deja-cli

Or with pipx for isolated environments:

bash

pipx install deja-cli

Verify installation

bash

deja --version
# deja 0.5.0

Connect to deja.sh (optional)

deja works fully offline with a local SQLite database. To enable cloud sync across machines, log in with your deja.sh account:

bash

deja login

This opens your browser, signs you in with Google, and writes a Personal Access Token to ~/.deja/auth.json. The CLI never sees your Google credentials.

Note: If you're on a headless server or CI, use deja login --token deja_<pat> with a token generated from the web dashboard under Settings → API Tokens.

Your first memory

bash

# Save a memory
deja save "Always use named volumes in docker-compose to avoid permission errors" --type gotcha

# Load memories relevant to a topic
deja load --context "docker networking"

# List everything
deja list

Update

bash

pip install --upgrade deja-cli

Uninstall

bash

pip uninstall deja-cli

# Remove local data (optional)
rm -rf ~/.deja