@ogulcancelik/pi-handoff

Context-aware session handoff for pi. Transfer context to a new session via command, tool, or automatic context guard.

Packages

Package details

extension

Install @ogulcancelik/pi-handoff from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@ogulcancelik/pi-handoff
Package
@ogulcancelik/pi-handoff
Version
1.0.5
Published
May 7, 2026
Downloads
203/mo · 8/wk
Author
ogulcancelik
License
MIT
Types
extension
Size
11.2 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./handoff.ts"
  ]
}

Security note

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

README

pi-handoff

Discontinued.

I am not using this extension anymore.

Why

The original goal of pi-handoff was agent-driven session handoff: let the current agent prepare the handoff and start the next session directly.

That depends on an API shape upstream pi still does not expose cleanly: extension tools cannot start a new session themselves in the same way command handlers can.

Without that, the extension ends up needing awkward workarounds:

  • hidden in-band prompts to make the current agent draft a handoff
  • scraping assistant replies back out of the session
  • brittle timing around when a new session should start

That is not robust enough to keep using.

What I use instead

I now use the upstream handoff example directly:

That approach is simpler and more reliable:

  1. read the current branch messages
  2. make a separate summarization call to generate the handoff prompt
  3. let the user review/edit it
  4. start the new session

It gives up the old "agent starts the next session itself" idea, but it works cleanly on upstream pi.

Status

This package is kept here as a discontinued experiment / reference, not an actively used extension.

License

MIT