Use the CLI

The dimple command covers local work, scripts, and quick checks. Run dimple --help to see the commands and global options in your installed version.

Create a configuration

Run dimple init in the directory where you want the database files:

dimple init

The command writes dimple.jsonc. Other commands read that file by default. To use another file, pass --config:

dimple query "deployment process" --config ./config/dimple.jsonc

Store and search memories

To write a memory, pass its text and a key. If you omit --key, Dimple generates one.

dimple write "Deployments run after each push" --key deploy-trigger

To search, ask a natural-language question:

dimple query "What starts a deployment?" --limit 5

By default, the query combines vector search and keyword search. To use one search mode, pass --profile semantic or --profile keyword. To narrow the result set, pass --namespace or --content-type.

Get or remove a memory

To read or delete a memory, pass its ID or logical key to get or forget:

dimple get deploy-trigger
dimple forget deploy-trigger

forget permanently deletes the memory, its graph edges, and its topic membership.

Print JSON

To print machine-readable results, add the global --json option:

dimple query "What starts a deployment?" --limit 5 --json

Next steps

• Index a codebase to add a source tree to memory.
• Connect an MCP client to let an MCP client call Dimple.
• Read the configuration reference for all settings.