Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.

Hindsight Documentation Skill Complete technical documentation for Hindsight a biomimetic memory system for AI agents. When to Use This Skill Use this skill when you need to: Understand Hindsight architecture and core concepts Learn about retain/recall/reflect operations Configure memory banks and dispositions Set up the Hindsight API server (Docker, Kubernetes, pip) Integrate with Python/Node.js/Rust SDKs Understand retrieval strategies (semantic, BM25, graph, temporal) Debug issues or optimize performance Review API endpoints and parameters Documentation Structure All documentation is in references/ organized by category: How to Find Documentation 1. Find Files by Pattern (use Glob tool) 2. Search Content (use Grep tool) 3. Read Full Documentation (use Read tool) Start Here: Best Practices Before reading API docs, read the best practices guide. It covers practical rules for missions, tags, content format, observation scopes, and anti patterns — the fastest way to integrate correctly. Key Concepts Memory Banks : Isolated memory stores (one per user/agent) Retain : Store memories (auto extracts facts/entities/relationships) Recall : Retrieve memories (4 parallel strategies: semantic, BM25, graph, temporal) Reflect : Disposition aware reasoning using memories document id : Groups messages in a conversation (upsert on same ID) Dispositions : Skepticism, literalism, empathy traits (1 5) affecting reflect Mental Models : Consolidated knowledge synthesized from facts Notes Code examples are inlined from working examples Configuration uses HINDSIGHT API environment variables Database migrations run automatically on startup Multi bank queries require client side orchestration Use document id for conversation evolution (same ID = upsert) Auto generated from hindsight docs/docs/ and hindsight docs/docs integrations/ . Run ./scripts/generate docs skill.sh to update.

hindsight-docs