All skills
vectorize-io avatar

/hindsight-docs

@5bfef3c
by vectorize-iovectorize-io/hindsight44k stars
5,845

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

Use this Skill: https://skilld.dev/gh/vectorize-io/hindsight/hindsight-docs

This session only. Nothing lands on disk.

referencessdksintegrationshermes-desktop.md

≈797 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Hermes Desktop

Configure Hindsight as the memory provider for the Hermes desktop app — entirely from Settings. No config.json, no .env, no terminal. Pick a mode, paste an API key, and Hermes remembers across every session.

💡 Tip

Prefer the command line, or running Hermes as a CLI/gateway? See the Hermes Agent integration for the hermes memory setup wizard, plugin architecture, and the full configuration reference.

Setup

1. Open Settings → Memory & Context. In the Memory Provider dropdown, choose Hindsight.

2. Fill in the Hindsight settings panel. Selecting Hindsight reveals its configuration fields:

Field What it does Default
Mode Cloud (just needs an API key) or Local External (connect to an existing Hindsight instance) Cloud
API key Authenticates with the Hindsight API — stored as a write-only secret —
API URL The Hindsight endpoint https://api.hindsight.vectorize.io
Bank ID Which memory bank this Hermes profile reads and writes hermes
Recall budget How hard recall works each turn: low / mid / high mid

3. Click Save. That's it — Hermes now has persistent long-term memory.

Connection Modes

Cloud (recommended)

The fast path. Choose Cloud, then paste an API key from ui.hindsight.vectorize.io/connect. Nothing to host — Hindsight Cloud handles storage, extraction, and retrieval.

Local External

Already running your own Hindsight instance (Docker or self-hosted)? Choose Local External and set the API URL to your instance (for example http://localhost:8888). Your memory never leaves your infrastructure.

How Memory Is Stored

Your settings are saved to the right place automatically:

  • API key goes to the secret store — it's never read back into the form (you'll see an API key set badge once it's saved).
  • Mode, API URL, Bank ID, and Recall budget are written to your Hermes profile config.

Each profile points at one Bank ID, so memory is isolated per profile and follows you across every machine that profile runs on.

Next Steps

Source: SKILL.md on GitHub

1 alert1d5 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The skill provides comprehensive technical documentation for the Hindsight memory system, covering its architecture, APIs, and various SDK integrations. It contains setup instructions and configuration guides for AI agents.

  • Socket1d

    1 alert: gptAnomaly

  • Snyk1d

    Risk: LOW · No issues

  • Runlayer6mo

    30/42 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 5bfef3c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 15 hours ago.

Activeupdated 2 months ago

README badge

README badge for vectorize-io/hindsight/hindsight-docs