cupld

Agent-friendly graph DB

cupld

An agent-friendly in-process graph DB, backed by markdown.

  • markdown-backed memory workflows
  • file-backed .cupld stores
  • no external runtime dependencies
Install now See the workflow

Use it for

Local graph work that stays operational.

01

Query from the CLI

Move from quick checks to repeated exploration without changing tools.

02

Sync markdown into local memory

Turn notes into a file-backed graph store with explicit paths and commands.

03

Build compact context for agents

Inspect the graph, pull concise context, and open the visual viewer when needed.

Workflow

Start local. Sync. Query. Visualise.

The core loop stays short enough to remember and concrete enough to trust.

cupld install bootstraps the markdown-memory flow. From there, the database path stays explicit and the same store can move between query commands and the viewer. 

cupld install
cupld sync markdown --db .cupld/default.cupld
cupld query --db .cupld/default.cupld 'MATCH (n) RETURN n LIMIT 10'
cupld --visualise .cupld/default.cupld

Install

Get the binary and start with a local store.

Homebrew

brew install aeaston1/tap/cupld

Cargo

cargo install cupld

Release assets are platform-specific. Choose the asset that matches your OS and architecture.