hindsight-cloud

Hindsight Memory Skill (Cloud)

You have persistent memory via Hindsight Cloud. This memory bank is 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 their API Key (get it from https://ui.hindsight.vectorize.io):

   mkdir -p ~/.hindsight
   cat > ~/.hindsight/config << 'EOF'
   api_url = "https://api.hindsight.vectorize.io"
   api_key = "<user's API key>"
   EOF
   chmod 600 ~/.hindsight/config
   

3. Get the bank ID - ask the user for their team's 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:

hindsight memory retain <bank-id> "The project uses ESLint configured with the Airbnb rule set and Prettier for formatting. Auto-fix on save is enabled in the editor config."
hindsight memory retain <bank-id> "Ran the test suite with NODE_ENV=test. Tests pass. Without NODE_ENV=test, the suite fails with a missing config error." --context procedures
hindsight memory retain <bank-id> "Build failed on Node 18 with error 'ERR_UNSUPPORTED_ESM_URL_SCHEME'. Switched to Node 20 and build succeeded." --context learnings
hindsight memory retain <bank-id> "Alice reviewed the PR and asked for verbose commit messages that explain the motivation, not just what changed." --context preferences