快速开始

首次运行

第一次运行 pis 时，pisces 会自动扫描已知的代理 CLI（如 claude、opencode、crush）和已安装的编辑器（VS Code、PyCharm、IntelliJ IDEA、Qoder、Cursor、Trae），并把检测到的所有内容写入配置 —— 没有询问，不需要手动选择。如果没有检测到任何东西，则从空配置开始。

无论哪种情况，配置文件都会创建在 ~/.pisces/settings.json，你可以随时编辑 —— pisces 会在保存后热加载，无需重启。

配置你的目标

在 ~/.pisces/settings.json 中添加项目目录（locations）和代理命令（agents）：

{
  "locations": [
    {
      "name": "docs",
      "path": "C:\\Users\\You\\Desktop\\docs",
      "key": "a"
    },
    {
      "name": "code",
      "path": "C:\\Users\\You\\Desktop\\code",
      "key": ["b", "beta"]
    }
  ],
  "agents": [
    {
      "name": "crush",
      "command": "crush",
      "key": "cs"
    },
    {
      "name": "opencode",
      "command": "opencode",
      "key": ["oc", "open"]
    },
    {
      "name": "claude",
      "command": "claude",
      "key": "cl",
      "args": ["--model", "sonnet"]
    }
  ],
  "default": {
    "path": "C:\\Users\\You\\Desktop\\code",
    "command": "claude"
  }
}

每个字段的说明见配置。

开始使用

运行 pis，然后输入：

输入	效果
b	显示 code 目录及其所有代理组合
boc	在 code 目录启动 opencode
bvscode	在 VS Code 中打开 code 目录
oc	在当前工作目录启动 opencode
b/	浏览 code 的子目录
Enter	启动选中的条目

整个心智模型就是：位置键 + 代理键，按前缀匹配。完整行为见搜索与键盘。