@vcsoc/pi-prompt-history

Project-scoped /history extension for pi with persistent prompt history stored in .pi/history/data.json

Packages

Package details

extension

Install @vcsoc/pi-prompt-history from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@vcsoc/pi-prompt-history
Package
@vcsoc/pi-prompt-history
Version
0.1.0
Published
Jun 1, 2026
Downloads
not available
Author
vcsoc
License
MIT
Types
extension
Size
12.5 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@vcsoc/pi-prompt-history

A pi package that adds a /history extension with project-scoped persistence.

Features

  • Tracks the last 50 user/assistant messages
  • Persists history per project to .pi/history/data.json
  • /history command to browse, show, and export history
  • alt+shift+up / alt+shift+down shortcuts to cycle history into the editor
  • One-line history widget below the editor

Install

From a local path:

pi install ./packages/pi-prompt-history

Project-local install:

pi install -l ./packages/pi-prompt-history

Or run pi with it for a one-off test:

pi -e ./packages/pi-prompt-history

Usage

  • /history - open the history picker
  • /history prev - load an older entry
  • /history next - load a newer entry
  • /history show - load the full transcript into the editor
  • /history export [path] - export transcript to a file

Persistence

History is stored in:

.pi/history/data.json

This makes history survive restarting pi even if you start a new session in the same project.

Sharing

You can share this package by:

  • committing this folder to a git repo and installing via pi install <git-url>
  • publishing it to npm and installing via pi install npm:@vcsoc/pi-prompt-history