@turbomem/cli

· Documentation

Command-line interface for turbomem local-first agent memory. Add, search, and manage memories directly from your terminal, with one-shot commands and an interactive shell.

Install

npm install -g @turbomem/cli
# or run without installing
npx @turbomem/cli init

Setup

turbomem init

This interactive wizard writes ~/.turbomem/config.json (embeddings + extraction providers, API keys, data directory). Environment variables (OPENAI_API_KEY, ANTHROPIC_API_KEY, TURBOMEM_DATA_DIR) and command flags override the saved config.

The CLI always uses PGlite storage on disk (default: ~/.turbomem/data). For edge deployments or Upstash Vector storage, use the turbomem SDK instead of the CLI.

Commands

# Remember something (LLM extracts discrete facts)
turbomem add "I love hiking and I'm training for a half marathon" --user user_123

# Store a verbatim fact, skipping extraction
turbomem add "Prefers dark mode" --fact --user user_123

# Semantic search
turbomem search "what outdoor activities is the user into?" --user user_123 --limit 5

# List everything in a scope
turbomem list --user user_123

# Delete one memory, or clear a whole scope
turbomem delete <id>
turbomem delete --all --user user_123

# Inspect resolved configuration
turbomem config

All memory commands accept scope flags: -u, --user, -a, --agent, -s, --session.

Interactive shell

Run turbomem with no arguments (or turbomem shell) to open the REPL:

turbomem ›

or

npx @turbomem/cli

Inside the shell:

| Command | Description | | ----------------- | ----------------------------------- | | add <text> | Remember text (LLM extraction) | | fact <text> | Remember text verbatim | | search <query> | Semantic search | | list | List memories in the current scope | | delete <id> | Delete a memory | | delete all | Delete every memory in the scope | | scope user <id> | Set scope (also agent, session) | | scope clear | Reset the scope | | help | Show help | | exit | Quit |

Documentation

Adapter guide and Next.js example:

https://docs.turbomem.dev/cli

License

Apache License 2.0