pisces

A terminal TUI launcher for AI coding agents — quickly open projects and agents from one place.

Features

• Keystroke-first search — type locationKey + agentKey prefixes to filter launch targets
• Agent combos — open a project directory and start an AI agent there in one keystroke
• Editor launch — open any location (or the current directory) in VS Code or another configured editor/IDE
• Subdirectory browsing — type locationKey + / to drill into a location
• Default launch — Ctrl+D opens your configured default path and command instantly (or a blank terminal when none is set)
• Recent opens — Ctrl+R lists your last 10 launches (with open time) and re-opens any of them
• Self-update — pis self-update upgrades to the latest npm version

Install

Requires Node.js 22 or later.

npm install -g @lysun001/pisces

Quick Start

Run pis to open the search palette:

pis

On first run, pisces detects installed agents and editors and initializes ~/.pisces/settings.json for you. Configure your project directories, agents, and editors there:

{
  "locations": [{ "name": "code", "path": "C:\\Users\\You\\Desktop\\code", "key": ["b", "beta"] }],
  "agents": [{ "name": "opencode", "command": "opencode", "key": ["oc", "open"] }],
  "editors": [{ "name": "VS Code", "command": "code", "key": "vscode" }]
}

Type b to see the directory, boc to launch it with opencode, b/ to browse its subdirectories.

Documentation

Full documentation: neptune-constellation.github.io/pisces (中文)

• Installation
• Quick Start
• Configuration reference
• Search & keyboard shortcuts
• Self-update
• FAQ

License

MIT