pi-goosedump

Pi extension for goosedump session search, durable memory, session management, and compaction

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-goosedump
Package
pi-goosedump
Version
0.12.57
Published
Aug 24, 2026
Downloads
10.3K/mo · 1,243/wk
Author
jarkkojs
License
Apache-2.0
Types
extension
Size
121.5 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.ts"
  ]
}

Security note

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

README

pi-goosedump

Pi extension for session search, durable memory, session management, and compaction. Tools use the goose_ prefix.

Install

pi install npm:pi-goosedump

The extension includes binaries for Linux x64/arm64, macOS arm64, and Windows x64. Set GOOSEDUMP_BINARY to an absolute executable path to override the packaged binary.

Tools

  • goose_search and goose_grep find session entries.
  • goose_get expands entry IDs to full content.
  • goose_remember, goose_recall, and goose_forget manage durable memory.
  • goose_memory_status reports memory storage health.
  • goose_compact compacts the current Pi session.
  • goose_sessions lists or deletes sessions for the current project.

Search and grep return entry IDs; call goose_get before relying on their content. Non-Pi providers require an explicit session ID.

Commands

/goose-search, /goose-compact, /goose-sessions, /goose-forget, /goose-memory-status, and /goose-settings.

Settings

Add goosedump to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "goosedump": {
    "turnsBeforeCompact": 0,
    "summaryMaxTokens": 4096,
    "enableMemory": false
  }
}

turnsBeforeCompact: 0 disables turn-based compaction. Memory learning runs in the background after successful compaction when memory is enabled.

Development

npm install
npm test
npm run check

Licensing

Apache 2.0.