Hindsight Memory Skill (Local)

You have persistent memory via the hindsight-embed CLI. Proactively store learnings and recall context to provide better assistance.

Setup Check (First-Time Only)

Before using memory commands, verify Hindsight is configured:

uvx hindsight-embed daemon status

If this fails or shows "not configured", run the interactive setup:

uvx hindsight-embed configure

This will prompt for an LLM provider and API key. After setup, the commands below will work.

How Hindsight Works

When you call retain, Hindsight does not store the string as-is. The server runs an internal pipeline that:

1. Extracts structured facts from the content using an LLM
2. Identifies entities (people, tools, concepts) and links related facts
3. Builds temporal and causal relationships between facts
4. Generates embeddings for semantic search

This means you should pass rich, full-context content, the server is better at extracting what matters than a pre-summarized string. Your job is to decide when to store, not what to extract.

Commands

Store a memory

Use memory retain to store what you learn. Pass the full context, raw observations, session notes, conversation excerpts, or detailed descriptions:

uvx hindsight-embed memory retain default "User is working on a TypeScript project. They enabled strict mode and prefer explicit type annotations over inference."
uvx hindsight-embed memory retain default "Ran the test suite with NODE_ENV=test. Tests pass. Without NODE_ENV=test, the suite fails with a missing config error." --context procedures
uvx hindsight-embed memory retain default "Build failed on Node 18 with error 'ERR_UNSUPPORTED_ESM_URL_SCHEME'. Switched to Node 20 and build succeeded." --context learnings

You can also pass a raw conversation transcript with timestamps: