goosedump

goosedump browses, searches, converts, summarizes, and compacts saved coding-agent sessions, with project-scoped durable memory. It supports Claude Code, Codex, Crush, Gemini CLI, Goose, OpenCode, and Pi.

Inspired by lllyasviel/VCC.

Install

Prebuilt binaries support Linux x64/arm64, macOS arm64, and Windows x64:

npm install --global @jarkkojs/goosedump

Build from source (Rust 1.95+, C compiler, Node.js 18+):

cargo build --release

Quick start

Session targets use provider:session-id. Bare IDs are not accepted.

goosedump summary
goosedump session list --provider pi
goosedump session show pi:context-id
goosedump session find pi:context-id '*database*'
goosedump session search pi:context-id 'database failure'
goosedump session compact pi:context-id
goosedump memory learn pi:context-id
goosedump memory recall 'database failure'

Full command reference: goosedump --help and the manual page.

Pi extension

The pi-goosedump extension adds session search, memory, session management, and compaction to Pi:

pi install npm:pi-goosedump

Integrations use their packaged binary by default; set GOOSEDUMP_BINARY to an absolute executable path to override it.

Local models

Optional text and embedding models download on first use into the standard Hugging Face Hub cache (~/.cache/huggingface/hub by default; see HF_HUB_CACHE / HF_HOME). Weights are not shipped with goosedump. Model notes: docs/models/.

Development

Check

make ci
CI_MSRV=1 make ci  # optional MSRV check

Update

Refresh lockfiles within current Cargo.toml / package.json ranges. Does not bump manifest pins. Skips this project's own npm packages.

make update

Package

Packages the highest semver tag reachable from HEAD on the current branch (not necessarily the tip). Source is built from a detached worktree at that tag; this packaging script stays on tip so tooling fixes apply without a new tag. Artifacts land in npm/*/bin and artifacts/ on the caller tree.

Non-host targets use cargo-zigbuild (Zig as linker). Requires cargo-zigbuild, zig, and the matching rustup targets (x86_64-unknown-linux-musl, aarch64-unknown-linux-musl, x86_64-pc-windows-gnu, aarch64-apple-darwin). Host-native triples use plain cargo. Darwin links CoreFoundation (chrono / iana-time-zone); from Linux set SDKROOT to a macOS SDK (Apple SDK; not redistributed).

make package
make package PLATFORMS='linux-x64 win32-x64'
PACKAGE_STRICT=1 make package

Release

After scripts/release.sh <version> and pushing the tag:

make ci
PACKAGE_STRICT=1 make package
make publish

make publish uses the highest semver tag reachable from HEAD (tip may be ahead). It publishes crates.io from that tagged tree, npm from local npm/*/bin artifacts, then uploads GitLab release tarballs when glab is available.

License

goosedump is free software under the GNU Lesser General Public License version 2.1 or later (LGPL-2.1+). See LICENSE-LGPL-2.1.

The pi-goosedump extension is under the Apache License 2.0. See packages/pi-goosedump/LICENSE.