# Hindsight Local

Store user preferences, learnings from tasks, and procedure outcomes.

- Repository: https://github.com/vectorize-io/hindsight (57678 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vectorize-io/hindsight --skill hindsight-local -g -a claude-code -y`
Codex: `npx skills add vectorize-io/hindsight --skill hindsight-local -g -a codex -y`
Cursor: `npx skills add vectorize-io/hindsight --skill hindsight-local -g -a cursor -y`
Gemini CLI: `npx skills add vectorize-io/hindsight --skill hindsight-local -g -a gemini-cli -y`

## Description

Store user preferences, learnings from tasks, and procedure outcomes. Use to remember what works and recall context before new tasks. (user)

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

```bash
uvx hindsight-embed daemon status
```

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

```bash
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:

```bash
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:

The rest: https://github.com/vectorize-io/hindsight/blob/HEAD/skills/hindsight-local/SKILL.md