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

A pi extension for **WSL** that makes **Alt+V** paste an image from the **Windows clipboard** into pi.

Instead of showing the temp file path in the editor, it inserts placeholders like `[Image #1]`, then replaces them with the real temp image paths when you submit.

## Install

Install from npm so it works with pi anywhere in WSL:

```bash
pi install npm:@lumendigitaldev/pi-wsl-images
```

For local development from this repo, run:

```bash
pi install .
```

After changes during development, run `/reload` or restart pi.

## Use

- `Alt+V` — paste a Windows clipboard image into pi as `[Image #n]`
- `/wsl-paste-image` — test the clipboard pipeline manually

## How it works

- Reads the native Windows clipboard via `powershell.exe`
- Writes the image to the WSL temp directory as `.png`
- Inserts `[Image #n]` in the editor, with numbering reset for each submitted message
- Replaces placeholders with real temp image paths at submit time

## Notes

- Intended for **WSL** only
- If `Alt+V` does not reach pi in your terminal, use `/wsl-paste-image` first to verify the clipboard pipeline