---
slug: "ctogg-pi-stash"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/cristeahub/pi-stash@main/README.md"
repo: "https://github.com/cristeahub/pi-stash"
source_file: "README.md"
branch: "main"
---
# pi-stash

Git-style prompt stashing for [pi](https://github.com/earendil-works/pi-mono).

Save what you're typing, clear the editor, and come back to it later.

## Install

```bash
pi install npm:@ctogg/pi-stash
```

Try it for a single session without adding it to your settings:

```bash
pi -e npm:@ctogg/pi-stash
```

To install into the current project only (writes to `.pi/settings.json`):

```bash
pi install -l npm:@ctogg/pi-stash
```

Then `/reload` in pi (or restart).

### Developing locally

Clone the repo and symlink the extension into your global extensions directory:

```bash
git clone https://github.com/cristeahub/pi-stash
cd pi-stash
ln -s "$(pwd)/prompt-stash.ts" ~/.pi/agent/extensions/prompt-stash.ts
```

Make sure the npm-installed version is removed first (`pi remove npm:@ctogg/pi-stash`) so you don't load two copies.

## Usage

### Shortcuts

| Key            | Action                    |
| -------------- | ------------------------- |
| `Ctrl+Q`       | Stash current editor text |
| `Ctrl+Shift+Q` | Stash with a message      |

### Commands

| Command        | Action                               |
| -------------- | ------------------------------------ |
| `/stash`       | Interactive stash picker             |
| `/stash list`  | Interactive stash picker             |
| `/stash pop`   | Picker locked to pop mode            |
| `/stash apply` | Picker locked to apply mode          |
| `/stash drop`  | Picker locked to drop mode           |
| `/stash clear` | Drop all stashes (with confirmation) |

### Picker Keys

| Key       | Action                                      |
| --------- | ------------------------------------------- |
| `j` / `↓` | Move down                                   |
| `k` / `↑` | Move up                                     |
| `Enter`   | Apply or pop (configurable, default: apply) |
| `a`       | Apply — paste into editor, keep stash       |
| `p`       | Pop — paste into editor, remove stash       |
| `d`       | Drop — delete stash without pasting         |
| `Esc` / `Ctrl+Q` | Close picker                           |

## Configuration

All settings in `~/.pi/stash-config.json`:

```json
{
  "stash": "ctrl+q",
  "stashWithMessage": "ctrl+shift+q",
  "enterAction": "apply"
}
```

| Key                | Default        | Description                                         |
| ------------------ | -------------- | --------------------------------------------------- |
| `stash`            | `ctrl+q`       | Quick stash shortcut                                |
| `stashWithMessage` | `ctrl+shift+q` | Stash with message shortcut                         |
| `enterAction`      | `"apply"`      | What Enter does in the picker: `"apply"` or `"pop"` |

Only include keys you want to override. `/reload` after editing.

## Storage

Stashes persist in `~/.pi/stash.json` across all sessions and projects.

## License

MIT