Installation

Pi Hindsight is published as an npm Pi package.

Install from npm

pi install npm:@luxusai/pi-hindsight

Use a version when you want a pinned install:

pi install npm:@luxusai/pi-hindsight@0.3.0

Install from GitHub source

Use GitHub source only when you intentionally want the repository state instead of the latest npm release:

pi install https://github.com/luxus/pi-hindsight

Local checkout installs are for contributors and test builds. See Development.

Choose a Hindsight server

Use Hindsight Cloud, a self-hosted Hindsight API server, or an embedded local daemon:

• Hindsight Cloud signup
• Self-hosted Hindsight installation
• 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. Pairs with the existing @vectorize-io/hindsight-client used by this extension.

The conventional local URL is:

http://localhost:8888

Pi Hindsight treats official Hindsight API behavior as the source of truth. Local Pi config selects banks and behavior; Hindsight owns Memory Bank storage, Retain, Recall, Reflect, bank config, mental models, and directives.

Next step

Open Pi in a repository and run:

/hindsight

If the repository has no project config yet, guided setup starts first.