Pi Hindsight S1 Enhanced

Persistent memory for Pi backed by Hindsight.

Documentation: https://dbydd.github.io/pi-hindsight-s1enhanced/

Pi Hindsight S1 Enhanced recalls relevant project memory before model calls, retains structured session deltas after completed agent runs, and exposes explicit memory tools for direct retain/recall/reflect operations.

What 1.0 adds

• Decision-driven bank routing. An optional model answers which banks a turn recalls from and which ones retain writes to, with an explicit fallback chain, a per-turn cache, and telemetry. Off by default; a failing decision costs routing quality, never memory. See Memory behavior.
• omp host support. Config paths, model roles, and the host's built-in memory backend are resolved from the running host, so one install serves Pi and omp. /hindsight:omp-backend switches omp's built-in backend off so a session has one memory entry point. See Tools and commands.
• Per-subagent memory profiles. A spawned omp subagent resolves its own banks and retain policy from hindsight-subagent.json, keyed by agent definition name, while the main session and every pi session keep reading hindsight.json. See Configure memory profiles.
• System One transport rung. The decision layer can call a gateway's System One endpoint in the protocol's own question form, which gives pi a typed decision path when its model registry cannot resolve a decision group. Off by default. See Configuration.

Install

Install the published npm package:

pi install npm:@dbydd/pi-hindsight-s1enhanced

You can still install from GitHub when you want the current repository source instead of the latest npm release:

pi install https://github.com/dbydd/pi-hindsight-s1enhanced

Package name: @dbydd/pi-hindsight-s1enhanced.

For local checkout installs, see Development.

Quick start

1. Start or choose a Hindsight server:
   • Hindsight Cloud signup
   • Self-hosted Hindsight installation; use Hindsight's built-in llama.cpp/local-LLM option when you want a no-LLM-API-key private setup
   • Embedded (no Docker): Install @vectorize-io/hindsight-all and use HindsightServer to start a local daemon programmatically. Requires uv/uvx and Python on the host.
2. Open Pi in your repo and run /hindsight.
3. Configure the Hindsight API URL. The default self-hosted URL is http://localhost:8888.
4. Choose the narrowest memory profile that fits the repo: Project + User, Project Only, User Only, or Recall Only.
5. Start coding. Recall happens before provider calls; retain happens after completed agent runs when the selected profile allows automatic retain.

See the getting started guide for setup details. Upgrading from older path-bank installs: Upgrading to domain banks.

Safety defaults

• Project memory stays in a project bank by default.
• User memory is opt-in and explicitly configured.
• Recall injection is ephemeral; recalled memory is not written back into transcripts.
• Automatic retain redacts common secrets before writing memory.
• Exact document deletion requires exact bank ID, exact document ID, and confirm: true.

See memory behavior and session memory modes for details.

Documentation

• Start — install and first setup
• Concepts — memory model, banks, queue, imports, safety
• Guides — task workflows for setup, diagnostics, imports, recovery, and domain-bank upgrades
• Reference — tools, commands, config, hooks, generated surface
• Development — contributor setup, checks, release, docs workflow

Development

npm install
npm run check

npm run check includes npm run docs:check, which verifies generated surface-reference freshness, generated code-map freshness, internal docs links/sidebar routes, packaged Markdown links, GitHub Pages base-prefixed docs links, and docs-site build.

Run Pi with the local extension:

pi -e ./extensions/index.ts

Install a local checkout into Pi when you need to test package loading from your working tree:

pi install /path/to/pi-hindsight-s1enhanced

For maintainer details, see Development setup and Release process.

Provenance

This repository continues luxus/pi-hindsight, which its maintainer archived on 2026-10-21. The published package was renamed from @luxusai/pi-hindsight to @dbydd/pi-hindsight-s1enhanced so the two lineages stay separable on npm; the memory bank layout, project tags, retain queue, and config keys are unchanged, and existing installs keep working. Version 1.0.0 is the first release under the new name and ships everything merged since 0.13.0, including the work listed above.

Upstream work is credited to luxus and the contributors of the original repository. Both this project and its upstream trace back to noctuid/pi-hindsight, which established the core idea; this package keeps that idea, then tightens project isolation, queue durability, diagnostics, and release hardening.