---
slug: "pi-claude-code-restore"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ismailsaleekh/pi-claude-code-restore@main/README.md"
repo: "https://github.com/ismailsaleekh/pi-claude-code-restore"
source_file: "README.md"
branch: "main"
---
# pi-claude-code-restore

Searchable restore, jump, fork, and label palette for [Pi](https://pi.dev/) sessions.

## Install

```bash
pi install npm:pi-claude-code-restore
```

Then reload Pi:

```text
/reload
```

## Usage

```text
/restore
/restore search terms
```

Shortcut:

```text
Alt+R
```

## Controls

| Key | Action |
|---|---|
| Type | Search current session entries |
| Up / Down | Move selection |
| PageUp / PageDown | Jump selection |
| Enter | Restore / jump to selected entry |
| Alt+F or Ctrl+F | Fork a new session at selected entry |
| Alt+L or Ctrl+L | Set or clear label |
| Alt+O or Ctrl+O | Cycle filter: smart, user, assistant, labeled, all |
| Alt+P or Ctrl+P | Toggle compact / expanded preview |
| Backspace | Edit search |
| Ctrl+U | Clear search |
| Esc | Clear search, then close |

## Behavior

- User messages restore the prompt into the editor for editing/resubmission.
- Assistant, tool, compaction, and summary entries jump the session leaf to that point.
- Fork creates a new session at the selected entry.
- Labels integrate with Pi session labels.

## Design

- No background watchers.
- No model calls.
- No auto-compaction.
- Current session only.
- Lightweight terminal overlay.

## Security

This extension reads the current Pi session tree and calls Pi session APIs. It does not read arbitrary project files, access network resources, or execute shell commands.

## License

MIT