@datspike/pi-fork-resume

Pi extension that forks a session selected through the resume-style session picker without opening the source session.

Package details

← Back
extension

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

npm repohome report
$ pi install npm:@datspike/pi-fork-resume
Package
@datspike/pi-fork-resume
Version
0.1.0
Published
May 2, 2026
Downloads
not available
Author
datspike
License
MIT
Types
extension
Size
13 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@datspike/pi-fork-resume

Pi extension that forks a session selected through the resume-style session picker without opening the source session.

Why

Pi already has useful primitives:

  • pi --fork <path|id> safely forks a session, but only at process startup.
  • /resume has the right global session picker, but opens the selected session as the active file.
  • /fork forks the current active session from a selected message.

This package fills the gap: choose any existing session from the resume picker, copy it into a new fork for the current project, and switch to that fork.

Install

pi install npm:@datspike/pi-fork-resume

For local development:

pi -e /home/spike/hobby/pi-fork-resume

Commands

/fork-resume

  1. Waits until the current agent turn is idle.
  2. Opens the same session picker component used by /resume.
  3. Lets you choose a session from the current project or all projects.
  4. Creates a new session via SessionManager.forkFrom(sourcePath, ctx.cwd, ctx.sessionManager.getSessionDir()).
  5. Switches to the newly created fork via ctx.switchSession(forkedFile).

The selected source session is not resumed and is not opened as the active session.

/fork-picker

Alias for /fork-resume.

Current /fork limitation

The intended long-term UX is to make /fork open the resume-style picker. In Pi 0.70.6, built-in interactive commands are handled before extension commands, and /fork is hardcoded to the current-session message picker. A package-level extension cannot safely override that behavior.

This extension deliberately avoids monkey patching Pi internals. When Pi exposes built-in command override hooks or changes command priority, the implementation can register /fork as a thin alias to the same workflow.

Development

npm install
npm run check

The architecture keeps Pi wiring thin:

  • src/index.ts registers commands and adapts Pi APIs.
  • src/fork-resume.ts contains the testable workflow.
  • src/session-label.ts contains fallback selector formatting helpers.
  • tests/*.test.ts cover cancellation, fork errors, switch cancellation, and option formatting.

Release

npm version patch
npm publish --access public

The package is published as a Pi package through the pi.extensions manifest in package.json.