memorable-kg 0.0.1

Project-scoped GraphRAG memory for agents.

Memorable

Memorable is a project-scoped GraphRAG memory system for agents.

It stores structured project memory in Neo4j and retrieves it through the memorable CLI and MCP server.

Quickstart

Use Memorable as a one-shot tool with uvx:

uvx --from memorable-kg memorable --help

For regular use, install it once:

uv tool install memorable-kg

The commands below assume the persistent install. If you prefer uvx, prefix each command with uvx --from memorable-kg (the published distribution is memorable-kg; the installed command is memorable).

Start in the project directory whose memory you want to manage:

mkdir memorable-quickstart
cd memorable-quickstart

Start the local Neo4j runtime:

memorable db start

Initialize the MemorySpace and write the Minimal MemoryProfile scaffold:

memorable init --space memorable-quickstart --description "Quickstart memory"

The scaffold lives at .memorable/memory.yaml:

version: 1

space:
  name: "memorable-quickstart"
  description: "Quickstart memory"

entities: []
relations: []
records: []

The Minimal scaffold has no write_policy block. Kernel record types persist immediately without profile declaration, so you can remember Decisions, Observations, and Tasks before adding project-specific types.

Check the runtime before writing memory:

memorable doctor

Remember your first Decision:

memorable remember decision \
  --id decision-first-memory \
  --statement "Use Memorable to keep project decisions searchable." \
  --source quickstart \
  --at 2026-05-30T00:00:00Z \
  --reason "Verify a fresh install can persist a kernel Decision."

Search for it with GraphRAG Retrieval:

memorable search --query "project decisions searchable"

The JSON result should include a hit like:

{
  "source_id": "decision-first-memory",
  "source_kind": "Decision"
}

More Information

Start with the product charter in docs/product.md.

Maintainers cutting 0.0.x releases should follow the release version ladder.