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

pi-goosedump is licensed under the Apache 2.0 license. See LICENSE for more information.