hindsight-self-hosted

Hindsight Memory Skill (Self-Hosted)

You have persistent memory via a self-hosted Hindsight server. This memory bank can be shared with the team, so knowledge stored here benefits everyone working on this codebase.

Proactively store team knowledge and recall context to provide better assistance.

Setup Check (First-Time Only)

Before using memory commands, verify the Hindsight CLI is configured:

cat ~/.hindsight/config

If the file doesn't exist or is missing credentials, help the user set it up:

1. Install the CLI (if hindsight command not found):

   curl -fsSL https://hindsight.vectorize.io/get-cli | bash
   

2. Create the config file - ask the user for:

   • API URL: Their self-hosted Hindsight server URL (e.g., https://hindsight.mycompany.com)
   • API Key: Their authentication key

   mkdir -p ~/.hindsight
   cat > ~/.hindsight/config << 'EOF'
   api_url = "<user's server URL>"
   api_key = "<user's API key>"
   EOF
   chmod 600 ~/.hindsight/config
   

3. Get the bank ID - ask the user for their bank ID (e.g., team-myproject)

After setup, use the bank ID in all commands below.

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

Replace <bank-id> with the user's actual bank ID (e.g., team-frontend).

Store a memory

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