pi-resume

Fast session resume for pi coding agent — /r2 instant resume, /rs paginated picker

Package details

extension

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

$ pi install npm:pi-resume

Pi manifest JSON

{
  "extensions": [
    "./extensions/index.ts"
  ]
}

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

Fast session resume for pi coding agent without reading all .jsonl files.

Built-in /resume reads and parses every line of every session file to build the picker. With hundreds of sessions this is slow.

Two commands that use stat() + lazy partial reads:

Command	What it does	Speed
`/r2`	Instantly switch to the most recent session	<50ms (stat-only)
`/rs`	Paginated picker: last 20, with tier navigation	<200ms first page

pi install npm:pi-fast-resume

Switches to the most recent session (by mtime) in one step. No picker, no parsing.

Shows a paginated list of recent sessions:

Relative time (e.g., "2h ago"), file size, session name or first message
▼ Load more... — next page within current filter
▼ Show 14d — expand to 14 days
▼ Show all — remove day filter entirely

Auto-escalates: if 7d is empty, jumps to 14d, then all.

/rs set page 30    # Sessions per page (1-50, default: 20)
/rs set days 14    # Day filter for first tier (0-30, 0 = no filter, default: 7)

Config is stored in ~/.pi/agent/extensions/pi-fast-resume/config.json.

/r2: readdir → stat each .jsonl → sort by mtime → switchSession(newest)
/rs: Same stat scan, then read only the first ~50 lines of each file on the current page to extract session name and first user message

No full file parsing. No buildSessionInfo(). No reading message content beyond the first user message.

git clone https://github.com/spex66/pi-fast-resume.git
cd pi-fast-resume
npm install
npm test

MIT