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 governed, typed excerpts with trust, confidence, scope, derivation, and provenance within a 4,096-byte/token-safe output budget. Quarantined, expired, superseded, and contradicted entries are excluded.
• goose_compact starts asynchronous compaction of the current Pi session. Set keep to preserve the last N user turns verbatim. Trained memory is indexed through goosedump's durable, bounded-retry ingestion ledger; inspect terminal failures with goosedump ingest review --status failed.

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 })

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-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 as hexadecimal: 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 passes --train so the compacted range is harvested into persistent memory, preserves the previous compaction summary, and asks goosedump to summarize only the newly compacted range. A keep:N request instead 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.