@kkskcs/pi-open

Open files with default app or current directory in finder, terminal, or split pane

Packages

Package details

extension

Install @kkskcs/pi-open from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@kkskcs/pi-open
Package
@kkskcs/pi-open
Version
0.1.0
Published
Jun 17, 2026
Downloads
not available
Author
kkskcs
License
MIT
Types
extension
Size
23 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/extensions/open/index.js"
  ],
  "image": "https://raw.githubusercontent.com/kkskcs/pi-lego/develop/packages/pi-open/assets/preview.png"
}

Security note

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

README

@kkskcs/pi-open

Open files with the default app, or open your current directory in finder, terminal, or a split pane — instantly from pi.

Installation

pi install npm:@kkskcs/pi-open

/open <path>

Opens a file or directory with the OS default application.

/open ./README.md
/open assets/
  • Files open in the associated default app
  • Directories open in the system file manager (Finder, Nautilus, Explorer)
  • Shows an error if the path does not exist
Platform Command
macOS open
Linux xdg-open
Windows start

Usage with pi-fff

When used with @ff-labs/pi-fff, you can use @-mention autocomplete to search and select files:

/open @src/index.ts
/open @package.json

The @ prefix is automatically stripped if the literal path is not found.

/open-cwd

Opens the current session working directory in another app.

/open-cwd

open-cwd

Runs as a command, so there's no AI response to wait for. No terminal-specific shortcuts to memorize — just pick an action, done. Works with Ghostty, WezTerm, iTerm2, kitty, tmux, and more — one unified interface regardless of which terminal you're in.

Features

  • Split pane — split the current terminal in a given direction
  • New terminal — open a new terminal window at cwd
  • Finder / File manager — reveal cwd in the system file manager
  • Fuzzy filter — type to narrow down actions
  • Unsupported actions are hidden from the list (no dead options)

Supported Terminals

macOS

Terminal Detection Split Directions New Window
Ghostty $TERM_PROGRAM=ghostty ✓ AppleScript up / down / left / right ✓ AppleScript
WezTerm $TERM_PROGRAM=WezTerm ✓ wezterm cli split-pane up / down / left / right ✓ wezterm cli spawn
tmux $TMUX ✓ tmux split-window up / down / left / right ✓ tmux new-window
iTerm2 $TERM_PROGRAM=iTerm.app ✓ AppleScript down / right ✓ open -a iTerm
kitty $TERM_PROGRAM=kitty ✓ kitty @ down / right ✓ kitty --directory
Alacritty $TERM_PROGRAM=alacritty — — ✓ alacritty --working-directory
Apple Terminal $TERM_PROGRAM=Apple_Terminal — — ✓ open -a Terminal
Warp $TERM_PROGRAM=WarpTerminal — — ✓ open -a Warp

Finder: open <cwd>

Linux

Terminal Detection Split Directions New Window
WezTerm $TERM_PROGRAM=WezTerm ✓ wezterm cli split-pane up / down / left / right ✓ wezterm cli spawn
tmux $TMUX ✓ tmux split-window up / down / left / right ✓ tmux new-window
kitty $TERM=xterm-kitty ✓ kitty @ down / right ✓ kitty --directory
Ghostty $TERM_PROGRAM=ghostty — — ✓ ghostty --working-directory
Alacritty $TERM=alacritty — — ✓ alacritty --working-directory

File manager: xdg-open <cwd>

Windows

Terminal Detection Split Directions New Window
WezTerm $TERM_PROGRAM=WezTerm ✓ wezterm cli split-pane up / down / left / right ✓ wezterm cli spawn
Windows Terminal $WT_SESSION ✓ wt sp down / right ✓ wt -w 0 -d
Alacritty $TERM_PROGRAM=alacritty — — ✓ alacritty --working-directory

Explorer: explorer <cwd>

Detection Priority

  1. $TMUX → tmux
  2. $WT_SESSION → Windows Terminal
  3. $TERM_PROGRAM → corresponding terminal
  4. $TERM → fallback (kitty, alacritty)

Development

cd packages/pi-open
pnpm install
pnpm run build