Hindsight Memory Skill (Local)

hindsight-embed

Setup Check (First-Time Only)

uvx hindsight-embed daemon status

uvx hindsight-embed configure

Commands

Store a memory

memory retain

uvx hindsight-embed memory retain default "User prefers TypeScript with strict mode"
uvx hindsight-embed memory retain default "Running tests requires NODE_ENV=test" --context procedures
uvx hindsight-embed memory retain default "Build failed when using Node 18, works with Node 20" --context learnings

Recall memories

memory recall

uvx hindsight-embed memory recall default "user preferences for this project"
uvx hindsight-embed memory recall default "what issues have we encountered before"

Reflect on memories

memory reflect

uvx hindsight-embed memory reflect default "How should I approach this task based on past experience?"

IMPORTANT: When to Store Memories

User Preferences

• Coding style (indentation, naming conventions, language preferences)
• Tool preferences (editors, linters, formatters)
• Communication preferences
• Project conventions

Procedure Outcomes

• Steps that successfully completed a task
• Commands that worked (or failed) and why
• Workarounds discovered
• Configuration that resolved issues

Learnings from Tasks

• Bugs encountered and their solutions
• Performance optimizations that worked
• Architecture decisions and rationale
• Dependencies or version requirements

IMPORTANT: When to Recall Memories

• Starting any non-trivial task
• Making decisions about implementation
• Suggesting tools, libraries, or approaches
• Writing code in a new area of the project

Best Practices

1. Store immediately: When you discover something, store it right away
2. Be specific: Store "npm test requires --experimental-vm-modules flag" not "tests need a flag"
3. Include outcomes: Store what worked AND what did not work
4. Recall first: Always check for relevant context before starting work