pi-goosedump

pi-goosedump adds goosedump-backed session search, durable memory, session management, and compaction to Pi. Its tools use the goose_ prefix.

Install

pi install npm:pi-goosedump

The package includes native binaries for Linux x64, macOS arm64, and Windows x64. On unsupported platforms, Pi keeps its normal compaction behavior and the goosedump tools report that they are unavailable. Local models download on first use.

Tools

• goose_search ranks session messages and returns entry IDs.
• goose_get expands entries returned by search or grep.
• goose_grep filters messages with a glob.
• goose_remember queues memory learning from a session.
• goose_recall recalls project-scoped memory with provenance.
• goose_compact compacts the current Pi session asynchronously.
• goose_sessions lists or deletes sessions in the current working directory.
• goose_forget deletes a memory or a session's retained sources.
• goose_memory_status reports storage and indexing health.

Session tools default to the current Pi session and active lineage. Non-Pi providers require a session ID. Recall returns up to five memories by default. Use each tool's schema for its full options.

Commands

• /goose-search [query] searches the current session.
• /goose-compact [keep:N] compacts now and can preserve recent user turns.
• /goose-sessions lists project sessions and can resume or delete them. Resume is available only for Pi sessions.
• /goose-forget [memory-id|provider:id] forgets stored memory.
• /goose-memory-status shows memory storage and indexing status.
• /goose-settings edits global and project compaction settings.

Settings

Put global settings in ~/.pi/agent/settings.json and project overrides in .pi/settings.json:

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

• turnsBeforeCompact: 0 to 255; 0 disables the turn trigger. Each completed model response counts as one turn. The footer shows the remaining count in hexadecimal.
• summaryMaxTokens: 512 to 65536; defaults to 4096. Pi limits the effective budget to 80% of compaction.reserveTokens when that is lower.

Pi's compaction.enabled controls automatic compaction. The first enabled context or turn limit reached starts one compaction; successful compaction resets the turn counter.

Manual and automatic compaction preserve the previous summary and summarize only new entries. keep:N leaves the last N user turns verbatim. Manual requests wait until Pi is idle, and memory learning runs in the background after success. If the turn limit expires during a tool loop, Pi saves the current batch, starts compaction at that turn boundary, and resumes automatically. Goosedump failures fall back to Pi's compactor.

License

Apache-2.0. See LICENSE.