# pi-trash

> Intercept `rm` commands and move files/directories to `.pi/trash/` instead of permanently deleting them.

## Overview

`pi-trash` is a [pi package](https://pi.dev/packages) that extends [pi](https://pi.dev) with a trash can for the coding agent. When the agent runs `rm`, files are moved to `.pi/trash/` instead of being permanently deleted, allowing recovery.

This follows the [freedesktop.org XDG Trash Specification](https://specifications.freedesktop.org/trash-spec/trashspec-1.1.html):

```
.pi/trash/
├── files/    ← actual deleted files
└── info/     ← .trashinfo metadata
```

## Features

- **`rm` interception** — Automatically detects and redirects `rm` commands to `.pi/trash/`
- **`/trash` command** — List and recover deleted files via the agent's slash command
- **CLI tool** — `bin/pi-trash-rm.mjs` for direct command-line usage
- **XDG Trash compatible** — Stores files and metadata in `.pi/trash/`

## Installation

### npm

```bash
pi install npm:pi-trash
```

### Git

```bash
pi install git:github.com/Jinsung-L/pi-trash
```

### Project-local

```bash
pi install npm:pi-trash -l
```

After installation, pi loads the extension automatically. No manual configuration needed.

## Usage

### Automatic `rm` interception

The agent's `rm` commands are automatically intercepted:

```
> rm some-file.txt
```

Files are moved to `.pi/trash/` in the project root instead of being deleted.

### `/trash` command

Manage trashed files using the `/trash` slash command. Supports four subcommands:

#### `/trash delete <paths...>`

Manually move files or directories to trash. This works the same way as the automatic `rm` interception.

```
/trash delete file1.txt
/trash delete dir1/ dir2/
/trash delete -v file1.txt file2.txt file3.txt   # verbose: show each deleted path
```

#### `/trash restore <id>`

Restore a trashed item to its original location.

```
/trash restore abc123def456...
```

The ID can be found via `/trash list`. The TUI provides autocomplete for the ID.

#### `/trash list`

List all trashed items (most recent first).

```
/trash list
```

#### `/trash empty [days]`

Permanently delete all trashed items (or items older than `<days>` days).

```
/trash empty                    # Delete all trashed items
/trash empty 7                  # Delete items older than 7 days
/trash empty 30d                # Same as above (d suffix is optional)
```

With UI, a confirmation dialog appears before deletion.