vectorize-io/hindsight156 files

Hindsight Docs

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

Specification
Skill ID
vectorize-io/hindsight/hindsight-docs
Publisher
vectorize-io
Repository
hindsight
Installs
0
Files
156
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

vectorize-io/hindsight/hindsight-docsInstalls these files
  • SKILL.md
  • references/best-practices.md
  • references/changelog/index.md
  • references/changelog/integrations/ag2.md
  • references/changelog/integrations/agent-framework.md
  • references/changelog/integrations/agentcore.md
  • references/changelog/integrations/ai-sdk.md
  • references/changelog/integrations/aider.md
  • references/changelog/integrations/autogen.md
  • references/changelog/integrations/chat.md
  • references/changelog/integrations/claude-agent-sdk.md
  • references/changelog/integrations/claude-code.md
  • references/changelog/integrations/cline.md
  • references/changelog/integrations/cloudflare-oauth-proxy.md
  • references/changelog/integrations/codex.md
  • references/changelog/integrations/coding-agents.md
  • references/changelog/integrations/composio.md
  • references/changelog/integrations/continue.md
  • references/changelog/integrations/copilot-cli.md
  • references/changelog/integrations/crewai.md
  • references/changelog/integrations/cursor-cli.md
  • references/changelog/integrations/cursor.md
  • references/changelog/integrations/devin-desktop.md
  • references/changelog/integrations/dify.md
  • references/changelog/integrations/eliza.md
  • references/changelog/integrations/eve.md
  • references/changelog/integrations/flowise.md
  • references/changelog/integrations/github-copilot.md
  • references/changelog/integrations/google-adk.md
  • references/changelog/integrations/haystack.md
  • references/changelog/integrations/langgraph.md
  • references/changelog/integrations/litellm.md
  • references/changelog/integrations/llamaindex.md
  • references/changelog/integrations/n8n.md
  • references/changelog/integrations/nemoclaw.md
  • references/changelog/integrations/obsidian.md
  • references/changelog/integrations/omo.md
  • references/changelog/integrations/openai-agents.md
  • references/changelog/integrations/openclaw.md
  • references/changelog/integrations/opencode.md
  • references/changelog/integrations/openhands.md
  • references/changelog/integrations/paperclip.md
  • references/changelog/integrations/pipecat.md
  • references/changelog/integrations/pydantic-ai.md
  • references/changelog/integrations/roo-code.md
  • references/changelog/integrations/smolagents.md
  • references/changelog/integrations/strands.md
  • references/changelog/integrations/superagent.md
  • references/changelog/integrations/vapi.md
  • references/changelog/integrations/zcode.md
  • references/changelog/integrations/zed.md
  • references/developer/admin-cli.md
  • references/developer/api/bank-templates.md
  • references/developer/api/documents.md
  • references/developer/api/knowledge-pages.md
  • references/developer/api/main-methods.md
  • references/developer/api/memories.md
  • references/developer/api/memory-banks.md
  • references/developer/api/mental-models.md
  • references/developer/api/operations.md
  • references/developer/api/quickstart.md
  • references/developer/api/recall.md
  • references/developer/api/reflect.md
  • references/developer/api/retain.md
  • references/developer/api/webhooks.md
  • references/developer/configuration.md
  • references/developer/development.md
  • references/developer/extensions.md
  • references/developer/index.md
  • references/developer/installation.md
  • references/developer/knowledge-pages.md
  • references/developer/mcp-server.md
  • references/developer/memory-defense/index.md
  • references/developer/mental-models.md
  • references/developer/models.md
  • references/developer/monitoring.md
  • references/developer/multilingual.md
  • references/developer/observations.md
  • references/developer/oracle.md
  • references/developer/performance.md
  • references/developer/rag-vs-hindsight.md
  • references/developer/reflect.md
  • references/developer/retain.md
  • references/developer/retrieval.md
  • references/developer/services.md
  • references/developer/storage.md
  • references/faq.md
  • references/openapi.json
  • references/sdks/cli.md
  • references/sdks/embed.md
  • references/sdks/go.md
  • references/sdks/hindsight-all-npm.md
  • references/sdks/hindsight-all.md
  • references/sdks/integrations/ag2.md
  • references/sdks/integrations/agent-framework.md
  • references/sdks/integrations/agent-plugin.md
  • references/sdks/integrations/agentcore.md
  • references/sdks/integrations/agno.md
  • references/sdks/integrations/ai-sdk.md
  • references/sdks/integrations/aider.md
  • references/sdks/integrations/autogen.md
  • references/sdks/integrations/chat.md
  • references/sdks/integrations/chatgpt.md
  • references/sdks/integrations/claude-agent-sdk.md
  • references/sdks/integrations/claude-code.md
  • references/sdks/integrations/cline.md
  • references/sdks/integrations/codex.md
  • references/sdks/integrations/coding-agents.md
  • references/sdks/integrations/composio.md
  • references/sdks/integrations/context-forge.md
  • references/sdks/integrations/continue.md
  • references/sdks/integrations/copilot-cli.md
  • references/sdks/integrations/crewai.md
  • references/sdks/integrations/cursor-cli.md
  • references/sdks/integrations/cursor.md
  • references/sdks/integrations/devin-desktop.md
  • references/sdks/integrations/dify.md
  • references/sdks/integrations/eliza.md
  • references/sdks/integrations/eve.md
  • references/sdks/integrations/flowise.md
  • references/sdks/integrations/gemini-spark.md
  • references/sdks/integrations/github-copilot.md
  • references/sdks/integrations/google-adk.md
  • references/sdks/integrations/grok-build.md
  • references/sdks/integrations/haystack.md
  • references/sdks/integrations/hermes-desktop.md
  • references/sdks/integrations/hermes.md
  • references/sdks/integrations/langgraph.md
  • references/sdks/integrations/litellm.md
  • references/sdks/integrations/llamaindex.md
  • references/sdks/integrations/local-mcp.md
  • references/sdks/integrations/n8n.md
  • references/sdks/integrations/nemoclaw.md
  • references/sdks/integrations/obsidian.md
  • references/sdks/integrations/omnigent.md
  • references/sdks/integrations/omo.md
  • references/sdks/integrations/openai-agents.md
  • references/sdks/integrations/openclaw.md
  • references/sdks/integrations/opencode.md
  • references/sdks/integrations/openhands.md
  • references/sdks/integrations/paperclip.md
  • references/sdks/integrations/perplexity.md
  • references/sdks/integrations/pipecat.md
  • references/sdks/integrations/pydantic-ai.md
  • references/sdks/integrations/right-agent.md
  • references/sdks/integrations/roo-code.md
  • references/sdks/integrations/skills.md
  • references/sdks/integrations/smolagents.md
  • references/sdks/integrations/strands.md
  • references/sdks/integrations/superagent.md
  • references/sdks/integrations/vapi.md
  • references/sdks/integrations/zapier.md
  • references/sdks/integrations/zcode.md
  • references/sdks/integrations/zed.md
  • references/sdks/nodejs.md
  • references/sdks/python.md

What this skill tells the agent

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:

references/
├── best-practices.md # START HERE — missions, tags, formats, anti-patterns
├── faq.md            # Common questions and decisions
├── changelog/        # Release history and version changes (index.md + integrations/)
├── openapi.json      # Full OpenAPI spec — endpoint schemas, request/response models
├── developer/
│   ├── api/          # Core operations: retain, recall, reflect, memory banks
│   └── *.md          # Architecture, configuration, deployment, performance
└── sdks/
    ├── *.md          # Python, Node.js, CLI, embedded
    └── integrations/ # Framework and tool integrations

How to Find Documentation

1. Find Files by Pattern (use Glob tool)

# Core API operations
references/developer/api/*.md

# SDK documentation
references/sdks/*.md
references/sdks/integrations/*.md

# Find specific topics
references/**/configuration.md
references/**/*python*.md
references/**/*deployment*.md

2. Search Content (use Grep tool)

# Search for concepts
pattern: "disposition"        # Memory bank configuration
pattern: "graph retrieval"    # Graph-based search
pattern: "helm install"       # Kubernetes deployment
pattern: "document_id"        # Document management
pattern: "HINDSIGHT_API_"     # Environment variables

# Search in specific areas
path: references/developer/api/
pattern: "POST /v1"           # Find API endpoints

path: references/sdks/
pattern: "def |async def "    # Find Python examples

3. Read Full Documentation (use Read tool)

references/developer/api/retain.md
references/sdks/python.md
references/sdks/integrations/litellm.md

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.

references/best-practices.md

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.

Use this skill in a project

Open any RiverX project, search the Skills panel for vectorize-io/hindsight/hindsight-docs, and install it in one click.

Use this skill