@nozomiishii/pm 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nozomi Ishii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,208 @@
+# pm - VS Code Project Manager CLI
+
+[English](./README.md) | 日本語
+
+<br>
+<div align="center">
+  <img src="demo/logo.gif" alt="logo" width="480" />
+</div>
+<br>
+
+[VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) をターミナルでも使いたい！
+
+`pm`コマンドだったらVS Code Project Managerに登録されたプロジェクトへ移動できます。
+
+## Prerequisites
+
+`pm`はインタラクティブなプロジェクト選択に[fzf](https://github.com/junegunn/fzf) を使用します。pm をセットアップする前にインストールしてください。
+
+```sh
+# macOS
+brew install fzf
+
+# Debian / Ubuntu
+sudo apt install fzf
+
+# Fedora
+sudo dnf install fzf
+
+# Arch Linux
+sudo pacman -S fzf
+```
+
+## Install
+
+### macOS/Linux (推奨)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/nozomiishii/pm/main/install.sh | bash
+```
+
+`pm`のバイナリが `~/.pm/bin/pm` にダウンロードされ、`pm`を呼び出すラッパースクリプトが `~/.pm/pm.zsh` に配置されます。`.zshrc` への設定も自動で追加されます。
+
+ターミナルを再起動するか、`source ~/.zshrc` を実行すると`pm`が使えるようになります。
+
+### npm
+
+```sh
+npm install -g @nozomiishii/pm
+```
+
+## Uninstall
+
+```sh
+pm uninstall
+```
+
+バイナリ・設定ファイル・`.zshrc` への追記をすべて削除します。
+
+## Usage
+
+### pm --help
+
+```
+Usage: pm [options] [command]
+
+Commands:
+  cd [name]                    Jump to a project (fzf if no name given)
+  ls                           List project names
+  logo                         Display the pm logo
+  uninstall                    Uninstall pm from your system
+  create-workspace             Generate a .code-workspace file
+    --name <name>              Workspace name (outputs <name>.code-workspace)
+    --tag <name>               Include only projects with this tag (repeatable)
+
+Options:
+  --config <path>              Path to projects.json (or PM_CONFIG)
+  --help                       Show this help
+
+Running `pm` without a command opens the fzf picker.
+```
+
+```sh
+pm --help
+```
+
+![pm --help](demo/pm-help.gif)
+
+### pm
+
+fzfピッカーを開いて、選択したプロジェクトへ移動します。
+
+```sh
+pm
+```
+
+![pm](demo/pm.gif)
+
+### pm cd
+
+プロジェクト名を指定して移動します。名前を省略するとfzfが開きます。
+
+```sh
+pm cd <name>
+```
+
+![pm cd](demo/pm-cd.gif)
+
+### pm ls
+
+プロジェクト名を一覧表示します。
+
+```sh
+pm ls
+```
+
+![pm ls](demo/pm-ls.gif)
+
+### pm create-workspace
+
+`--tag` で指定したタグのプロジェクトを `.code-workspace` ファイルにまとめます。
+
+```sh
+pm create-workspace --name <name> --tag <tag>
+```
+
+たとえば `projects.json` に以下のプロジェクトがある場合:
+
+```json
+[
+  { "name": "dotfiles",  "rootPath": "~/Code/nozomiishii/dotfiles",  "tags": ["personal"] },
+  { "name": "portfolio", "rootPath": "~/Code/nozomiishii/portfolio", "tags": ["personal"] },
+  { "name": "fzf",       "rootPath": "~/Code/junegunn/fzf",         "tags": ["oss"]      }
+]
+```
+
+次のコマンドを実行することで
+
+```sh
+pm create-workspace --name my-workspace --tag personal
+```
+
+`my-workspace.code-workspace` が生成されます:
+
+```json
+{
+  "folders": [
+    { "name": "dotfiles",  "path": "../nozomiishii/dotfiles" },
+    { "name": "portfolio", "path": "../nozomiishii/portfolio" }
+  ]
+}
+```
+
+`--tag` は複数指定でき、すべてのタグを持つプロジェクトだけが含まれます。
+
+## Configuration
+
+インストーラーが `.zshrc` を自動で設定しますが、手動でセットアップする場合は以下を追加してください。
+
+```sh
+# (任意) projects.json のパスを指定。省略すると VS Code Project Manager のデフォルトパスを使用
+export PM_CONFIG="$HOME/path/to/projects.json"
+
+# 必須設定
+export PATH="$HOME/.pm/bin:$PATH"
+source "$HOME/.pm/pm.zsh"
+```
+
+### PM_CONFIG
+
+pm は `projects.json` ファイルからプロジェクト情報を読み込みます。`PM_CONFIG` を省略した場合は [VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) のデフォルトパスを参照します。
+
+| OS | デフォルトパス |
+| --- | --- |
+| macOS | `~/Library/Application Support/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+| Linux | `~/.config/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+| Windows | `%APPDATA%/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+
+`--config` フラグで一時的にパスを指定することもできます。
+
+```sh
+pm --config ./projects.json ls
+```
+
+### source "$HOME/.pm/pm.zsh"
+
+`pm` バイナリは別プロセスで実行されるため、バイナリ内で `cd` しても呼び出し元のシェルのディレクトリは変わりません。`source "$HOME/.pm/pm.zsh"` で読み込まれるシェル関数が、バイナリの出力がディレクトリだった場合に現在のシェルで `cd` を実行します。
+
+```sh
+# pm.zsh がやっていること (簡略版)
+pm() {
+  local output
+  output="$(command pm "$@")"       # バイナリを実行
+  [[ -d "$output" ]] && cd "$output"  # 出力がディレクトリなら cd
+}
+```
+
+この仕組みにより、プロジェクト名のタブ補完もサポートしています。
+
+## 謝辞
+
+pm は以下のプロジェクトから大きな影響を受けています。僕の生産性を上げてくれて本当にありがとうございます
+
+- [VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) — `projects.json` ベースのプロジェクト切り替えを切り開いた拡張機能です。最高で最高です。
+- [Raycast VSCode Project Manager](https://www.raycast.com/MarkusLanger/vscode-project-manager) — RaycastからVS Code Project Managerが使えます。アメージングです。
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,208 @@
+# pm - VS Code Project Manager CLI
+
+English | [日本語](./README.ja.md)
+
+<br>
+<div align="center">
+  <img src="demo/logo.gif" alt="logo" width="480" />
+</div>
+<br>
+
+I wanted to use [VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) from the terminal too!
+
+With the `pm` command, you can jump to any project registered in VS Code Project Manager.
+
+## Prerequisites
+
+`pm` uses [fzf](https://github.com/junegunn/fzf) for interactive project selection. Install it before setting up pm.
+
+```sh
+# macOS
+brew install fzf
+
+# Debian / Ubuntu
+sudo apt install fzf
+
+# Fedora
+sudo dnf install fzf
+
+# Arch Linux
+sudo pacman -S fzf
+```
+
+## Install
+
+### macOS/Linux (recommended)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/nozomiishii/pm/main/install.sh | bash
+```
+
+The `pm` binary is downloaded to `~/.pm/bin/pm`, and the wrapper script that calls `pm` is placed at `~/.pm/pm.zsh`. The `.zshrc` configuration is added automatically.
+
+Restart your terminal or run `source ~/.zshrc` to start using pm.
+
+### npm
+
+```sh
+npm install -g @nozomiishii/pm
+```
+
+## Uninstall
+
+```sh
+pm uninstall
+```
+
+Removes the binary, config files, and `.zshrc` entries.
+
+## Usage
+
+### pm --help
+
+```
+Usage: pm [options] [command]
+
+Commands:
+  cd [name]                    Jump to a project (fzf if no name given)
+  ls                           List project names
+  logo                         Display the pm logo
+  uninstall                    Uninstall pm from your system
+  create-workspace             Generate a .code-workspace file
+    --name <name>              Workspace name (outputs <name>.code-workspace)
+    --tag <name>               Include only projects with this tag (repeatable)
+
+Options:
+  --config <path>              Path to projects.json (or PM_CONFIG)
+  --help                       Show this help
+
+Running `pm` without a command opens the fzf picker.
+```
+
+```sh
+pm --help
+```
+
+![pm --help](demo/pm-help.gif)
+
+### pm
+
+Opens fzf picker and jumps to the selected project.
+
+```sh
+pm
+```
+
+![pm](demo/pm.gif)
+
+### pm cd
+
+Jumps to a project by name. Falls back to fzf if no name is given.
+
+```sh
+pm cd <name>
+```
+
+![pm cd](demo/pm-cd.gif)
+
+### pm ls
+
+Lists all project names.
+
+```sh
+pm ls
+```
+
+![pm ls](demo/pm-ls.gif)
+
+### pm create-workspace
+
+Bundles projects matching a `--tag` into a `.code-workspace` file.
+
+```sh
+pm create-workspace --name <name> --tag <tag>
+```
+
+For example, given the following `projects.json`:
+
+```json
+[
+  { "name": "dotfiles",  "rootPath": "~/Code/nozomiishii/dotfiles",  "tags": ["personal"] },
+  { "name": "portfolio", "rootPath": "~/Code/nozomiishii/portfolio", "tags": ["personal"] },
+  { "name": "fzf",       "rootPath": "~/Code/junegunn/fzf",         "tags": ["oss"]      }
+]
+```
+
+Running the following command:
+
+```sh
+pm create-workspace --name my-workspace --tag personal
+```
+
+Generates `my-workspace.code-workspace`:
+
+```json
+{
+  "folders": [
+    { "name": "dotfiles",  "path": "../nozomiishii/dotfiles" },
+    { "name": "portfolio", "path": "../nozomiishii/portfolio" }
+  ]
+}
+```
+
+`--tag` can be specified multiple times — only projects matching all tags are included.
+
+## Configuration
+
+The installer configures `.zshrc` automatically. For manual setup, add the following:
+
+```sh
+# (Optional) Path to projects.json. Defaults to the VS Code Project Manager path
+export PM_CONFIG="$HOME/path/to/projects.json"
+
+# Required
+export PATH="$HOME/.pm/bin:$PATH"
+source "$HOME/.pm/pm.zsh"
+```
+
+### PM_CONFIG
+
+pm reads project data from a `projects.json` file. If `PM_CONFIG` is omitted, it defaults to the [VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) config path.
+
+| OS | Default path |
+| --- | --- |
+| macOS | `~/Library/Application Support/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+| Linux | `~/.config/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+| Windows | `%APPDATA%/Code/User/globalStorage/alefragnani.project-manager/projects.json` |
+
+You can also override the path temporarily with the `--config` flag:
+
+```sh
+pm --config ./projects.json ls
+```
+
+### source "$HOME/.pm/pm.zsh"
+
+The `pm` binary runs as a separate process, so `cd` inside the binary cannot change the calling shell's directory. The shell function loaded by `source "$HOME/.pm/pm.zsh"` runs `cd` in the current shell when the binary outputs a directory path.
+
+```sh
+# What pm.zsh does (simplified)
+pm() {
+  local output
+  output="$(command pm "$@")"       # Run the binary
+  [[ -d "$output" ]] && cd "$output"  # cd if output is a directory
+}
+```
+
+This mechanism also provides tab completion for project names.
+
+## Acknowledgments
+
+pm is heavily inspired by these projects. Thank you so much for boosting my productivity.
+
+- [VS Code Project Manager](https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager) — The extension that pioneered `projects.json`-based project switching. The best of the best.
+- [Raycast VSCode Project Manager](https://www.raycast.com/MarkusLanger/vscode-project-manager) — Use VS Code Project Manager from Raycast. Amazing.
+
+## License
+
+[MIT](LICENSE)

package/dist/cli.js

@@ -0,0 +1,291 @@
+// src/cli.ts
+import { existsSync } from "node:fs";
+import { readFile as readFile2, writeFile } from "node:fs/promises";
+import path3 from "node:path";
+import { spawn } from "node:child_process";
+
+// src/filter-projects.ts
+function filterProjects(projects, tags) {
+  return projects.filter((p) => {
+    if (p.enabled === false)
+      return false;
+    if (tags.length > 0) {
+      return tags.every((t) => p.tags?.includes(t));
+    }
+    return true;
+  });
+}
+
+// src/expand-home.ts
+import path from "node:path";
+function expandHome(p) {
+  if (p.startsWith("~/")) {
+    return path.join(process.env.HOME ?? "", p.slice(2));
+  }
+  if (p === "~") {
+    return process.env.HOME ?? "";
+  }
+  return p;
+}
+
+// src/strip-emoji-label.ts
+function stripEmojiLabel(s) {
+  let t = s.normalize("NFC");
+  for (let i = 0;i < 4; i++) {
+    t = t.replace(/\p{Extended_Pictographic}/gu, "").replace(/\p{Emoji_Modifier}/gu, "").replace(/\u200d/g, "").replace(/\ufe0f/g, "").replace(/\ufe0e/g, "");
+  }
+  return t.replace(/\s+/g, " ").trim();
+}
+
+// src/find-project.ts
+function findProject(projects, query) {
+  const matches = projects.filter((p) => {
+    if (p.name === query)
+      return true;
+    const plain = stripEmojiLabel(p.name);
+    return plain === query;
+  });
+  if (matches.length > 1) {
+    throw new Error(`Ambiguous name "${query}" matches: ${matches.map((p) => p.name).join(", ")}`);
+  }
+  return matches[0];
+}
+
+// src/create-workspace/build-folders.ts
+import path2 from "node:path";
+function buildFolders(projects, opts) {
+  const filtered = filterProjects(projects, opts.tags);
+  const folders = [];
+  for (const p of filtered) {
+    const absolute = path2.resolve(expandHome(p.rootPath));
+    let rel = path2.relative(opts.workspaceDir, absolute);
+    if (!rel || rel === "") {
+      rel = ".";
+    }
+    const relPosix = rel.split(path2.sep).join("/");
+    const name = stripEmojiLabel(p.name) || path2.basename(absolute);
+    folders.push({ name, path: relPosix });
+  }
+  return folders;
+}
+
+// src/create-workspace/load-existing-workspace.ts
+import { readFile } from "node:fs/promises";
+async function loadExistingWorkspace(workspacePath) {
+  try {
+    const raw = await readFile(workspacePath, "utf8");
+    const parsed = JSON.parse(raw);
+    const { folders: _f, ...rest } = parsed;
+    return rest;
+  } catch {
+    return {};
+  }
+}
+
+// src/logo/logo-color.ascii
+var logo_color_default = `\x1B[38;2;120;180;255m zzzzzzzzzzzzzzzzzzzzzzzzzz\x1B[0m
+\x1B[38;2;100;160;245m zzzzzzzzzzzzzzzzzzzzzzzzzz\x1B[0m
+\x1B[38;2;80;140;235mzzzzz.----.______.zzzzzzzzz\x1B[0m
+\x1B[38;2;60;120;225mzzzzz |    __________zzzzzz\x1B[0m
+\x1B[38;2;45;100;215mzzzzz |   /           /zzzz\x1B[0m
+\x1B[38;2;30;80;205mzzzzz |  /           /zzzzz\x1B[0m
+\x1B[38;2;20;65;195mzzzzz | /       pm  /zzzzzz\x1B[0m
+\x1B[38;2;10;50;185mzzzzz |/__________ /zzzzzzz\x1B[0m
+\x1B[38;2;10;50;185mnozozzzzzzzzzzzzzzzzzzzzzz\x1B[0m
+\x1B[38;2;10;50;185mzzzzzzzzzzzzzzzzzzzzzzzzzz\x1B[0m
+`;
+
+// src/cli.ts
+function defaultConfigPath() {
+  const home = process.env.HOME ?? "";
+  switch (process.platform) {
+    case "darwin":
+      return path3.join(home, "Library/Application Support/Code/User/globalStorage/alefragnani.project-manager/projects.json");
+    case "win32":
+      return path3.join(process.env.APPDATA ?? "", "Code/User/globalStorage/alefragnani.project-manager/projects.json");
+    default:
+      return path3.join(home, ".config/Code/User/globalStorage/alefragnani.project-manager/projects.json");
+  }
+}
+function usage() {
+  console.log(`Usage: pm [options] [command]
+
+Commands:
+  cd [name]                    Jump to a project (fzf if no name given)
+  ls                           List project names
+  logo                         Display the pm logo
+  uninstall                    Uninstall pm from your system
+  create-workspace             Generate a .code-workspace file
+    --name <name>              Workspace name (outputs <name>.code-workspace)
+    --tag <name>               Include only projects with this tag (repeatable)
+
+Options:
+  --config <path>              Path to projects.json (or PM_CONFIG)
+  --help                       Show this help
+
+Running \`pm\` without a command opens the fzf picker.`);
+}
+function printLogo() {
+  console.log(logo_color_default);
+}
+var SUBCOMMANDS = new Set(["cd", "ls", "create-workspace", "logo", "uninstall"]);
+function parseArgs(argv) {
+  let config = process.env.PM_CONFIG ?? defaultConfigPath();
+  let help = false;
+  let subcommand;
+  const rest = [];
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--config") {
+      config = argv[++i] ?? "";
+    } else if (arg === "--help") {
+      help = true;
+    } else if (!subcommand && SUBCOMMANDS.has(arg)) {
+      subcommand = arg;
+    } else {
+      rest.push(arg);
+    }
+  }
+  return { config, help, subcommand, rest };
+}
+function parseCreateWorkspaceArgs(rest) {
+  let workspaceName = "";
+  const tags = [];
+  for (let i = 0;i < rest.length; i++) {
+    const arg = rest[i];
+    if (arg === "--name") {
+      workspaceName = rest[++i] ?? "";
+    } else if (arg === "--tag") {
+      tags.push(rest[++i] ?? "");
+    }
+  }
+  return { workspaceName, tags };
+}
+function plainLabel(name) {
+  return stripEmojiLabel(name) || name;
+}
+function fzfSelect(projects) {
+  return new Promise((resolve, reject) => {
+    const labels = projects.map((p) => plainLabel(p.name));
+    const proc = spawn("fzf", [], {
+      stdio: ["pipe", "pipe", "inherit"]
+    });
+    let stdout = "";
+    proc.stdout.on("data", (d) => {
+      stdout += d.toString();
+    });
+    proc.stdin.write(labels.join(`
+`) + `
+`);
+    proc.stdin.end();
+    proc.on("close", (code) => {
+      if (code !== 0) {
+        resolve(undefined);
+        return;
+      }
+      const selected = stdout.trim();
+      const idx = labels.indexOf(selected);
+      resolve(idx >= 0 ? projects[idx] : undefined);
+    });
+    proc.on("error", (err) => {
+      if (err.code === "ENOENT") {
+        console.error("fzf is not installed. Install it or pass a project name directly.");
+        resolve(undefined);
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+function resolveCliPath(p) {
+  return path3.isAbsolute(p) ? path3.normalize(p) : path3.resolve(process.cwd(), p);
+}
+async function createWorkspace(projects, args) {
+  if (!args.workspaceName) {
+    console.error("Error: --name is required with create-workspace.");
+    process.exit(1);
+  }
+  const workspacePath = resolveCliPath(`${args.workspaceName}.code-workspace`);
+  const workspaceDir = path3.dirname(path3.resolve(workspacePath));
+  const folders = buildFolders(projects, { tags: args.tags, workspaceDir });
+  const preserved = await loadExistingWorkspace(workspacePath);
+  const out = { ...preserved, folders };
+  await writeFile(workspacePath, JSON.stringify(out, null, 2) + `
+`, "utf8");
+  console.log(`Wrote ${workspacePath} (${folders.length} folders)`);
+}
+async function jumpToProject(projects, name) {
+  let target;
+  if (name) {
+    target = findProject(projects, name);
+    if (!target) {
+      console.error(`Project not found: ${name}`);
+      process.exit(1);
+    }
+  } else {
+    target = await fzfSelect(projects);
+    if (!target) {
+      process.exit(1);
+    }
+  }
+  const dir = expandHome(target.rootPath);
+  if (!existsSync(dir)) {
+    console.error(`Directory not found: ${dir}`);
+    process.exit(1);
+  }
+  console.log(dir);
+}
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    usage();
+    process.exit(0);
+  }
+  if (args.subcommand === "logo") {
+    printLogo();
+    process.exit(0);
+  }
+  if (args.subcommand === "uninstall") {
+    const url = "https://raw.githubusercontent.com/nozomiishii/pm/main/uninstall.sh";
+    const proc = spawn("bash", ["-c", `curl -fsSL "${url}" | bash`], {
+      stdio: "inherit"
+    });
+    proc.on("close", (code) => process.exit(code ?? 0));
+    return;
+  }
+  const filePath = expandHome(args.config);
+  if (!existsSync(filePath)) {
+    console.error(`File not found: ${filePath}`);
+    process.exit(1);
+  }
+  const raw = await readFile2(filePath, "utf-8");
+  const allProjects = JSON.parse(raw);
+  switch (args.subcommand) {
+    case "create-workspace": {
+      const cwArgs = parseCreateWorkspaceArgs(args.rest);
+      await createWorkspace(allProjects, cwArgs);
+      break;
+    }
+    case "ls": {
+      const projects = filterProjects(allProjects, []);
+      for (const p of projects) {
+        console.log(plainLabel(p.name));
+      }
+      break;
+    }
+    case "cd": {
+      const projects = filterProjects(allProjects, []);
+      await jumpToProject(projects, args.rest[0]);
+      break;
+    }
+    default: {
+      const projects = filterProjects(allProjects, []);
+      await jumpToProject(projects);
+      break;
+    }
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nozomiishii/pm",
+  "version": "0.1.0",
+  "description": "Project manager CLI — jump to projects via fzf",
+  "type": "module",
+  "homepage": "https://github.com/nozomiishii/pm#readme",
+  "bugs": {
+    "url": "https://github.com/nozomiishii/pm/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nozomiishii/pm.git"
+  },
+  "license": "MIT",
+  "author": "Nozomi Ishii",
+  "bin": {
+    "pm": "./dist/cli.js"
+  },
+  "files": [
+    "dist/cli.js",
+    "src/pm.zsh"
+  ],
+  "scripts": {
+    "build": "bun build --compile src/cli.ts --outfile dist/pm",
+    "prepublishOnly": "bun build src/cli.ts --outfile dist/cli.js --target=node",
+    "typecheck": "tsc --noEmit",
+    "dev": "bun run src/cli.ts",
+    "demo": "docker run --rm -v \"$(pwd)\":/vhs pm-vhs",
+    "demo:all": "bash demo/create.sh",
+    "demo:logo": "docker run --rm -v \"$(pwd)\":/vhs pm-vhs demo/logo.tape",
+    "logo:colorize": "bun run src/logo/create-logo-color.ts",
+    "install:local": "bash install.sh",
+    "uninstall:local": "bash uninstall.sh",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.15",
+    "vitest": "4.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "node": "24.14.0"
+  }
+}

package/src/pm.zsh

@@ -0,0 +1,26 @@
+# pm — project manager shell wrapper
+# Source this file from .zshrc to enable `pm` and tab completion.
+#
+# Required:
+#   export PM_CONFIG="$HOME/Code/nozomiishii/workspaces/projects.json"
+
+pm() {
+  local output
+  output="$(command pm "$@")" || return
+  case "${1:-}" in
+    ls|create-workspace|--help)
+      printf '%s\n' "$output"
+      ;;
+    *)
+      [[ -d "$output" ]] && cd "$output" || printf '%s\n' "$output"
+      ;;
+  esac
+}
+
+_pm() {
+  local -a names
+  names=("${(@f)$(command pm ls 2>/dev/null)}")
+  compadd -a names
+}
+
+compdef _pm pm