pi-ephemeral

Toggle Pi session persistence mid-session (delete session file on exit)

Package details

← Back
extension

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

npm repohome report
$ pi install npm:pi-ephemeral
Package
pi-ephemeral
Version
0.1.4
Published
Apr 5, 2026
Downloads
335/mo · 13/wk
Author
w-winter
License
MIT
Types
extension
Size
7.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "extensions/ephemeral-mode.ts"
  ]
}

Security note

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

README

Pi Ephemeral Mode (pi-ephemeral)

Toggle session persistence on/off mid-session.

When enabled, Pi deletes the current session file on exit (useful for throwaway sessions that you don't want cluttering /resume).

Install

From npm:

pi install npm:pi-ephemeral

From the dot314 git bundle (filtered install):

Add to ~/.pi/agent/settings.json (or replace an existing unfiltered git:github.com/w-winter/dot314 entry):

{
  "packages": [
    {
      "source": "git:github.com/w-winter/dot314",
      "extensions": ["extensions/ephemeral-mode.ts"],
      "skills": [],
      "themes": [],
      "prompts": []
    }
  ]
}

Usage

  • Command: /ephemeral
  • Shortcut: Alt+E

Notes

  • If trash is available, it's used to remove the session file (safer). Otherwise it falls back to direct deletion
  • If you're already running an in-memory/ephemeral session (no session file), there's nothing to delete