pi-session-bookmark

Browser-style session bookmarks for pi — /bookmarks, /bookmark-add, /bookmark-remove

Packages

Package details

extension

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

$ pi install npm:pi-session-bookmark
Package
pi-session-bookmark
Version
0.1.0
Published
Sep 10, 2026
Downloads
123/mo · 123/wk
Author
cyzlmh
License
MIT
Types
extension
Size
10.9 KB
Dependencies
0 dependencies · 3 peers
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

pi-session-bookmark

Browser-style bookmarks for pi sessions: keep a short list of the sessions you actually want again, and jump back into one from any project.

Install

pi install npm:pi-session-bookmark

Then /reload or restart pi.

Usage

  • /bookmark-add [name] — bookmark the current session under a name. The name is optional: without one it falls back to the session's display name, then to a preview of the first user message. Re-adding updates the name in place.
  • /bookmarks [query] — open the bookmark picker. Enter resumes the selected session and switches to its working directory. An optional query filters by name, preview, or path.
  • /bookmark-remove — remove the current session's bookmark. Silent no-op if the session isn't bookmarked (idempotent, like rm).

How it works

  • Bookmarks are global — one list across all projects and working directories.
  • Stored in ~/.pi/agent/session-bookmarks.json (honors PI_CODING_AGENT_DIR). Session files themselves are never modified.
  • Rows show name · directory · date; entries whose session file no longer exists are marked [missing] and can be removed from the picker.
  • Selecting the session you're already in reports "Already in this session" instead of switching.

Requirements

  • pi on your PATH (Node ≥ 22).

License

MIT