pi-goosedump

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

Install

pi install npm:pi-goosedump

The package installs @jarkkojs/goosedump, including native binaries for Linux x64, macOS arm64, and Windows x64. If no compatible binary is available, the extension keeps Pi's normal compaction behavior and its goosedump features report that they are unavailable.

Tools

• goose_search ranks session messages and returns compact overviews with entry IDs.
• goose_get expands entry IDs returned by goose_search or goose_grep.
• goose_grep filters session messages with a glob pattern.
• goose_recall searches memory harvested by earlier compactions. It searches the current working directory by default, can filter decisions, facts, preferences, procedures, or episodes, and returns typed excerpts with provenance within a 4,096-byte/token-safe output budget.
• goose_compact starts asynchronous compaction of the current Pi session. Set keep to preserve the last N user turns verbatim.
• goose_sessions lists or deletes saved sessions scoped to the current working directory. Deleting the active session is safety-blocked.
• goose_forget deletes stored durable memory by content hash or provider:id. Writes durable tombstones to prevent re-learning.
• goose_memory_status inspects durable-memory counts and indexing health. The session-history tools accept an optional provider (pi by default), session, and scope (lineage by default or all). The current Pi session is used when both provider and session are omitted. Non-Pi providers require an explicit session ID. Targets sent to goosedump are always provider-qualified.

Examples:

goose_search({ query: "bug fix" })
goose_search({ query: "auth", scope: "all", page: 2 })
goose_get({ ids: ["entry-a", "entry-b"] })
goose_grep({ pattern: "*timeout*" })
goose_recall({ query: "prior architecture decision" })
goose_recall({ query: "database", type: "decision" })
goose_compact({ keep: 2 })
goose_sessions({ action: "list" })
goose_forget({ hash: "a1b2c3d4..." })
goose_memory_status({})

Commands

• /goose-search [query] searches the current session. A bare command opens an inline prompt; selecting a result expands it.
• /goose-compact [keep:N] compacts now. With keep:N, the last N user turns remain verbatim; without it, Pi chooses the cut point.
• /goose-sessions lists or deletes saved sessions scoped to the current working directory.
• /goose-forget [hash|provider:id] deletes stored durable memory by hash or session.
• /goose-memory-status displays durable-memory storage health and indexing counts.
• /goose-settings edits global and project compaction settings.

Settings

Optional settings live under goosedump in:

• ~/.pi/agent/settings.json for global settings.
• .pi/settings.json for project overrides.

{
  "goosedump": {
    "turnsBeforeCompact": 0
  }
}

turnsBeforeCompact is an integer from 0 to 255. 0 disables scheduled compaction. The countdown is restored when a session resumes and appears in the footer with a status dot (green when >25% turns remain, yellow when ≤25%, red when ≤12.5%) followed by hexadecimal turn countdown: ● GD: 0A means ten turns remain, ● GD: 00 is ready to compact, and ● GD: -- is disabled. Clearing the project value restores the global setting.

Compaction behavior

The extension replaces Pi's normal summary during manual, scheduled, and automatic compaction. It invokes goosedump session compact --remember, preserves the previous compaction summary, and summarizes only the newly compacted range. A keep:N request keeps the last N active user turns; it is cancelled when no earlier history is available to summarize.

Compactions with custom instructions continue to use Pi's normal compactor. If goosedump fails, the extension reports the error and falls back to Pi. Successful compactions report memory-learning warnings without discarding the summary.

License

pi-goosedump is licensed under Apache-2.0. See LICENSE.