pi-goosedump

Coding agent context data browser plugin for pi using goosedump.

Install

pi install npm:pi-goosedump

This installs pi-goosedump and its @jarkkojs/goosedump dependency, which includes platform-specific native binaries for Linux, macOS, and Windows.

The upstream @jarkkojs/goosedump packages are licensed separately as Apache-2.0 AND LGPL-2.1-or-later.

Usage

Once installed, pi-goosedump registers a tool and a slash command:

Tool: goosedump

The agent can browse the current Pi session by default, or any session by its 8-hex contextId (the id shown by list):

Action	Description
list	List all available sessions
search	Rank messages by query relevance
grep	Filter messages by glob pattern
expand	Show full content for specific entry IDs
view	View the full session transcript

Examples:

goosedump({ action: "list" })
goosedump({ action: "search", query: "bug fix" })
goosedump({ action: "search", contextId: "0000001f", query: "bug fix" })
goosedump({ action: "grep", pattern: "*rand*" })
goosedump({ action: "expand", ids: ["entry-a", "entry-b"] })
goosedump({ action: "view" })

Other providers

By default the tool browses Pi sessions. Set provider (one of claude, codex, crush, gemini, goose, opencode, pi) with a contextId to browse another tool's sessions; results render the same way as Pi sessions. Non-pi providers have no current session, so they require an explicit contextId.

goosedump({ action: "list", provider: "claude" })
goosedump({ action: "view", provider: "claude", contextId: "0000001f" })

Raw native output

By default every action renders through the normal structured view. Set outputFormat to emit the raw native session instead — one of claude, codex, crush, gemini, goose, opencode, pi, or json. JSONL providers (claude, codex, pi, gemini) emit the raw session file; SQLite providers (crush, goose, opencode) emit a row-oriented JSON projection of their tables; json emits goosedump's structured JSON. This is round-trippable and applies to view, expand, grep, and search.

goosedump({ action: "view", outputFormat: "goose" })
goosedump({ action: "grep", pattern: "*rand*", outputFormat: "claude" })

Command: /goosedump

Opens an interactive session browser.

Compaction

pi-goosedump hooks Pi's /compact and auto-compaction flow. It resolves the current session to its goosedump id and runs goosedump compact <id> with Pi's compaction range (--from, --until, and --scope) so the generated summary matches the entries Pi is about to replace.

License

pi-goosedump is licensed under MIT. See LICENSE for more information.