pi-hindsight-companion

A standard Pi / PiWeb package for the official Hindsight coding-agent extension. Independent Windows tray manager available in the source repository.

Packages

Package details

extension

Install pi-hindsight-companion from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-hindsight-companion
Package
pi-hindsight-companion
Version
0.1.4
Published
Nov 13, 2026
Downloads
699/mo · 699/wk
Author
leozedd
License
MIT
Types
extension
Size
42.2 KB
Dependencies
1 dependency · 0 peers
Pi manifest JSON
{
  "skills": [],
  "themes": [],
  "prompts": [],
  "extensions": [
    "./extension/hindsight.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Hindsight Companion

简体中文

Use Hindsight memory in Pi and PiWeb, and manage a Windows Hindsight server from the system tray.

  • Pi / PiWeb package: exposes the official Hindsight extension and its companion skill as a manageable Pi package.
  • Windows tray: starts, stops and updates the API and Control Plane for an existing native CUDA deployment.

The two components can be used independently. Plugin updates and server updates are separate operations.

Install the Pi package

Requires Node.js 22+, Pi and a running Hindsight server.

pi install npm:pi-hindsight-companion

In PiWeb, use Settings → Plugins → Add plugin and enter npm:pi-hindsight-companion.

Load or reload Pi after installation. On a new setup, the plugin creates a disabled configuration template at ~/.pi/agent/hindsight.json. Set the server address, API token and bank, then change disabled to false and reload Pi. See the configuration guide.

In PiWeb, open Settings → Plugins to enable or disable the package. Reload the affected session to apply the change.

Use a project bank

Open a session in the project directory and run /hindsight-project. Companion adds the official directory-to-bank mapping and reloads Pi; no manual path entry is needed. See project registration for custom bank IDs and a personal fallback.

Update

Use PiWeb's Check / Update actions, or run:

pi update --extensions

Reload the session afterward. Updates install the latest Companion release and its specified official runtime version. Official runtime updates become available when included in a Companion release.

Install the Windows tray

The tray uses an existing CUDA API environment, Control Plane and embedded PostgreSQL database. Follow Windows setup to install the scripts and Start Menu shortcut.

From the tray menu:

  • 启动前后端 — start the API and Control Plane.
  • 停止前后端（释放显存） — stop services and the embedded database.
  • 检查并更新前后端… — back up and update the server components.

The management page opens at http://127.0.0.1:9999.

Documentation

MIT licensed. Community project built on Vectorize's Hindsight; see NOTICE for attribution.