Installation

pisces is distributed on npm as @lysun001/pisces.

Requirements

• Node.js 22 or later
• A terminal on Windows, macOS, or Linux (see platform support)

Install

npm install -g @lysun001/pisces

Then run it:

pis

The search palette opens immediately. See Quick Start for the first-run walkthrough.

Keeping up to date

Run the built-in updater at any time:

pis self-update

See Self-Update for details.

Platform support

When you launch an entry, pisces opens a new terminal window at the target directory:

Platform	Terminal
Windows	PowerShell (new window via cmd /c start)
macOS	Terminal.app (via osascript)
Linux	Auto-detected: gnome-terminal → x-terminal-emulator → xterm → konsole → xfce4-terminal → terminator → alacritty

Uninstall

npm uninstall -g @lysun001/pisces

Your configuration in ~/.pisces/ is left untouched; delete that directory manually if you want it gone.