# goosedump

`goosedump` browses, searches, summarizes, and compacts saved coding-agent
sessions. It also maintains project-scoped durable memory.

## Install

```sh
npm install --global @jarkkojs/goosedump
```

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

## Usage

Session targets use `provider:session-id`.

```sh
goosedump summary
goosedump session list --provider pi
goosedump session show pi:context-id
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'
```

Run `goosedump --help` or see [goosedump(1)](man/man1/goosedump.1) for the full
command reference.

## Pi extension

```sh
pi install npm:pi-goosedump
```

See [pi-goosedump](packages/pi-goosedump/README.md). Set `GOOSEDUMP_BINARY` to
an absolute executable path to override its packaged binary.

Optional local models download into the Hugging Face cache on first use. See
[model notes](docs/models/).

## Development

```sh
make ci
```

## Licensing

`goosedump` uses [LGPL-2.1+](LICENSE).

The Pi extension uses [Apache 2.0](packages/pi-goosedump/LICENSE).