FAQ

Where is my configuration stored?

~/.pisces/settings.json (%USERPROFILE%\.pisces\settings.json on Windows). The directory and file are created automatically on first run. See Configuration.

Do I need to restart pis after editing settings.json?

No. The config file is watched and hot-reloaded — save the file and the palette updates while pisces is running.

What characters can I use in a key?

Lowercase letters, digits, and hyphens only ([a-z0-9-]), 1–20 characters each. Keys are search triggers, not display names — the name field can contain anything, including CJK characters.

Can a location or agent have multiple keys?

Yes. Pass an array: "key": ["b", "beta"]. The entry matches when any of its keys matches.

I pressed Ctrl+D and got a warning — why?

The default section in your settings.json is empty or missing. Add it to enable the shortcut:

"default": { "path": "/path/to/project", "command": "claude" }

On macOS, Cmd+D works the same way. See Configuration → default.

Why doesn't subdirectory browsing combine with agents?

A location can contain many subdirectories, and combining each with every configured agent produces a Cartesian product of options — the palette would become unusable. So subdirectory mode opens a plain terminal; start your agent manually. See Subdirectory Browsing.

Which terminal opens when I launch an entry?

A new terminal window at the target directory: PowerShell on Windows, Terminal.app on macOS, and an auto-detected emulator on Linux. See Installation → platform support.

How do I update pisces?

pis self-update

See Self-Update.

How do I uninstall?

npm uninstall -g @lysun001/pisces

Remove ~/.pisces/ manually to delete your configuration.