pi-side-preview

Right-side file and image preview extension for pi.

Package details

← Back
extension

Install pi-side-preview from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-side-preview
Package
pi-side-preview
Version
0.1.1
Published
May 5, 2026
Downloads
not available
Author
samo33ddd
License
MIT
Types
extension
Size
25.1 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-side-preview

Right-side file, code, and image preview extension for pi.

English | Русский

Features

  • Opens text and code files in a right-side overlay preview.
  • Keeps pi's input editor usable while the preview is open.
  • Syntax highlighting for common file types through pi's Markdown/code renderer.
  • Opens images (png, jpg, jpeg, gif, webp) in a full custom view so terminal inline images can render correctly.
  • Remembers preview width/height between openings in the current pi process.
  • Resizable preview width and height.
  • Mouse wheel scrolling, with a toggle for native terminal text selection.
  • Copy visible text or the entire text file to clipboard on macOS via pbcopy.
  • Configurable open shortcuts and in-preview keys.

Install

From npm:

pi install npm:pi-side-preview

From GitHub/Git:

pi install git:github.com/samo33ddd/pi-side-preview

With a pinned tag or branch:

pi install git:github.com/samo33ddd/pi-side-preview@v0.1.0

From a local checkout:

pi install /path/to/pi-side-preview

For development/testing without installing:

pi -e /path/to/pi-side-preview

After installing or editing the extension, run:

/reload

Commands

Open a file/image preview:

/side-preview <path>

If no path is passed, the extension tries the first line of the clipboard, then asks for a path.

Configure global shortcut(s) used to open/toggle the preview:

/side-preview-bind show
/side-preview-bind reset
/side-preview-bind ctrl+alt+o ctrl+shift+o

Changing open shortcuts requires /reload.

Configure keys used inside the preview:

/side-preview-keys show
/side-preview-keys reset
/side-preview-keys toggleWheel=ctrl+m copyView=ctrl+y copyAll=ctrl+shift+y widthGrow=alt+left widthShrink=alt+right heightShrink=alt+up heightGrow=alt+down close=escape

Reopen the preview to apply in-preview key changes.

Default shortcuts

Open/toggle preview:

  • Ctrl+Shift+O
  • Ctrl+Alt+O

Default preview controls:

  • Ctrl+M: toggle mouse wheel mode
  • Ctrl+Y: copy visible view
  • Ctrl+Shift+Y: copy all text
  • Alt+Left / Alt+Right: resize width
  • Alt+Up / Alt+Down: resize height
  • Esc: close

Selection and scrolling

By default, mouse wheel mode is enabled for convenient scrolling. Toggle it with Ctrl+M:

  • wheel on: scroll the preview with mouse/trackpad wheel;
  • wheel off/select: use native terminal mouse selection to copy selected text.

Keyboard copy is also available with Ctrl+Y and Ctrl+Shift+Y for text files.

Config

User config is stored at:

~/.pi/agent/side-preview.json