job-apply-plugin 0.1.1 → 0.3.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "job-apply",
       "source": "./plugin",
       "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
-      "version": "0.1.1",
+      "version": "0.3.0",
       "category": "productivity"
     }
   ]

package/README.md

@@ -22,13 +22,27 @@ pnpm dlx job-apply-plugin install
 yarn dlx job-apply-plugin install
 ```
 
-The installer finds the apps you have and installs into each of them. To choose a target yourself:
+The installer asks which version you want:
+
+```
+Where should Job Apply be installed?
+  1) Claude Code  (found on this computer)
+  2) ChatGPT desktop / Codex  (found on this computer)
+  3) Both
+Choose 1, 2 or 3 [3]:
+```
+
+Each version goes only into its own app's folder. To skip the menu, for example in a script, use a flag:
 
 ```bash
 npx job-apply-plugin install --claude     # Claude Code only
 npx job-apply-plugin install --chatgpt    # ChatGPT desktop / Codex only
+npx job-apply-plugin install --all        # both
 ```
 
+When there's no terminal to show the menu in (CI, scripts) and no flag is given, it installs into
+the apps it finds on the computer.
+
 You can also install it globally and use the shorter command after that:
 
 ```bash
@@ -60,23 +74,45 @@ npm install -g job-apply-plugin && job-apply-plugin install
 The installer never overwrites a folder it didn't create unless you pass `--force`.
 When you add Job Apply to an existing `marketplace.json`, the other entries in that file are kept.
 
+## Uninstall
+
+```bash
+npx job-apply-plugin uninstall
+```
+
+It asks which app to remove Job Apply from, and shows where it's currently installed:
+
+```
+Remove Job Apply from which app?
+  1) Claude Code  (installed v0.3.0)
+  2) ChatGPT desktop / Codex  (not installed)
+  3) Both
+Choose 1, 2 or 3 [1]:
+```
+
+To skip the menu, use `--claude`, `--chatgpt` or `--all`. `remove` works as another name for `uninstall`.
+For ChatGPT, also click **Uninstall** on its Plugins page, then restart the app.
+
+Uninstalling keeps your résumé, profile and application history in `~/Documents/Job Apply`.
+To erase those too, ask the assistant to "clear my Job Apply profile" before you uninstall,
+or delete that folder.
+
+> `npm uninstall -g job-apply-plugin` only removes the installer, not the plugin.
+> Run `uninstall` first.
+
 ## Other commands
 
 ```bash
 npx job-apply-plugin status      # where it's installed and whether Python is OK
 npx job-apply-plugin install     # run again to update
-npx job-apply-plugin uninstall   # removes the plugin and keeps your profile and history
 ```
 
-To erase your saved profile and history, ask the assistant to "clear my Job Apply profile",
-or delete `~/Documents/Job Apply`.
-
 ## Installing from the Git repository (alternative)
 
 The repository is also a plugin marketplace for both apps.
 
-- Claude Code: `claude plugin marketplace add <owner>/<repo>` then `claude plugin install job-apply@job-apply`
-- Codex: `codex plugin marketplace add <path-or-repo>`
+- Claude Code: `claude plugin marketplace add filipelinemburger/job-apply` then `claude plugin install job-apply@job-apply`
+- Codex: `codex plugin marketplace add https://github.com/filipelinemburger/job-apply.git`
 
 ## Privacy
 

package/bin/job-apply.js

@@ -8,6 +8,7 @@ import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
+import readline from "node:readline/promises";
 
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const PLUGIN_SRC = path.join(PACKAGE_ROOT, "plugin");
@@ -54,11 +55,12 @@ function assertReplaceable(dest, force) {
   }
 }
 
-function replaceDir(src, dest, { force, target }) {
+function replaceDir(src, dest, { force, target, exclude = [] }) {
   assertReplaceable(dest, force);
+  const skip = new Set([...SKIP, ...exclude]);
   fs.rmSync(dest, { recursive: true, force: true });
   fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.cpSync(src, dest, { recursive: true, filter: (p) => !SKIP.has(path.basename(p)) });
+  fs.cpSync(src, dest, { recursive: true, filter: (p) => !skip.has(path.basename(p)) });
   writeMarker(dest, target);
 }
 
@@ -161,7 +163,8 @@ const chatgpt = {
       : { name: DEFAULT_MARKETPLACE, interface: { displayName: "Local Plugins" }, plugins: [] };
     if (!Array.isArray(market.plugins)) market.plugins = [];
 
-    replaceDir(PLUGIN_SRC, this.pluginDir(), { ...opts, target: this.id });
+    // ChatGPT gets the portable plugin; the Claude Code manifest stays out of its copy.
+    replaceDir(PLUGIN_SRC, this.pluginDir(), { ...opts, target: this.id, exclude: [".claude-plugin"] });
 
     const entry = {
       name: PLUGIN_NAME,
@@ -229,29 +232,122 @@ Usage
 
 Commands
   install      Install (or update) the plugin
-  uninstall    Remove the plugin (your profile and history in ~/Documents/Job Apply are kept)
+  uninstall    Remove the plugin from Claude Code, ChatGPT or both (alias: remove).
+               Your profile and history in ~/Documents/Job Apply are kept.
   status       Show where the plugin is installed and check Python
 
 Options
-  --claude     Target Claude Code only
-  --chatgpt    Target ChatGPT desktop / Codex only (alias: --codex)
+  --claude     Claude Code only
+  --chatgpt    ChatGPT desktop / Codex only (alias: --codex)
+  --all        Both apps
   --project    Claude Code: use ./.claude/skills in this folder instead of ~/.claude/skills
   --force      Overwrite existing folders that were not installed by this tool
   -h, --help   Show this help
   -v, --version
 
-With no target flag, every detected app is used (both if none is detected).`;
+Run "install" with no app flag to pick from a menu: Claude Code, ChatGPT, or both.
+Without a terminal to ask in (CI, scripts), it installs into the apps found on this computer.
+"uninstall" with no app flag shows the same menu (without a terminal, it removes from both).`;
 
-function pickTargets(values) {
+const CHOICES = {
+  1: ["claude"],
+  2: ["chatgpt"],
+  3: ["claude", "chatgpt"],
+};
+
+// Turns a menu answer into target ids; empty input takes the default. Returns null if unrecognised.
+export function parseChoice(answer, defaultChoice = "3") {
+  const a = String(answer ?? "").trim().toLowerCase() || String(defaultChoice);
+  if (["1", "claude", "claude code", "c"].includes(a)) return CHOICES[1];
+  if (["2", "chatgpt", "codex", "openai", "g"].includes(a)) return CHOICES[2];
+  if (["3", "both", "all", "b"].includes(a)) return CHOICES[3];
+  return null;
+}
+
+function flagTargets(values) {
+  if (values.all) return Object.values(TARGETS);
   const chosen = [];
   if (values.claude) chosen.push(claude);
   if (values.chatgpt || values.codex) chosen.push(chatgpt);
-  if (chosen.length) return chosen;
-  const detected = Object.values(TARGETS).filter((t) => t.detect());
-  return detected.length ? detected : Object.values(TARGETS);
+  return chosen;
+}
+
+// Shows the 1/2/3 menu. `notes` maps each target to a hint shown next to it; `verb` is "installed" or "removed".
+async function askTargets({ title, notes, defaultChoice, verb }) {
+  const cancelled = `Cancelled. Nothing was ${verb}.`;
+  log(title);
+  log(`  1) Claude Code${notes(claude)}`);
+  log(`  2) ChatGPT desktop / Codex${notes(chatgpt)}`);
+  log(`  3) Both`);
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.on("SIGINT", () => {
+    log(`\n${cancelled}`);
+    process.exit(130);
+  });
+  try {
+    for (let attempt = 0; attempt < 3; attempt++) {
+      let answer;
+      try {
+        answer = await rl.question(`Choose 1, 2 or 3 [${defaultChoice}]: `);
+      } catch (err) {
+        // Ctrl+D or a closed terminal
+        if (err?.name === "AbortError" || err?.code === "ABORT_ERR") throw new CliError(cancelled);
+        throw err;
+      }
+      const ids = parseChoice(answer, defaultChoice);
+      if (ids) {
+        log();
+        return ids.map((id) => TARGETS[id]);
+      }
+      log("  Please type 1, 2 or 3.");
+    }
+  } finally {
+    rl.close();
+  }
+  throw new CliError(`No choice made. Nothing was ${verb}.`);
 }
 
-export function main(argv = process.argv.slice(2)) {
+const interactive = () => Boolean(process.stdin.isTTY && process.stdout.isTTY);
+const choiceFor = (list) => (list.length === 1 ? (list[0] === claude ? "1" : "2") : "3");
+
+async function pickInstallTargets(values) {
+  const flagged = flagTargets(values);
+  if (flagged.length) return flagged;
+  const found = Object.values(TARGETS).filter((t) => t.detect());
+  if (interactive()) {
+    return askTargets({
+      title: "Where should Job Apply be installed?",
+      notes: (t) => (found.includes(t) ? "  (found on this computer)" : ""),
+      defaultChoice: choiceFor(found),
+      verb: "installed",
+    });
+  }
+  // No terminal to ask in: fall back to the apps found here (both if none).
+  const targets = found.length ? found : Object.values(TARGETS);
+  log(`No app chosen; installing for ${targets.map((t) => t.label).join(" and ")}. Use --claude, --chatgpt or --all to choose.`);
+  return targets;
+}
+
+// Returns [] when there is nothing to remove.
+async function pickUninstallTargets(values, opts) {
+  const flagged = flagTargets(values);
+  if (flagged.length) return flagged;
+  const statuses = new Map(Object.values(TARGETS).map((t) => [t, t.status(opts)]));
+  const installed = [...statuses].filter(([, s]) => s !== "not installed").map(([t]) => t);
+  if (installed.length === 0) {
+    log("Job Apply isn't installed in Claude Code or ChatGPT on this computer. Nothing to remove.");
+    return [];
+  }
+  if (!interactive()) return Object.values(TARGETS);
+  return askTargets({
+    title: "Remove Job Apply from which app?",
+    notes: (t) => `  (${statuses.get(t).replace(/ \(.*$/, "").replace(/ — .*$/, "")})`,
+    defaultChoice: choiceFor(installed),
+    verb: "removed",
+  });
+}
+
+export async function main(argv = process.argv.slice(2)) {
   const { values, positionals } = parseArgs({
     args: argv,
     allowPositionals: true,
@@ -259,6 +355,7 @@ export function main(argv = process.argv.slice(2)) {
       claude: { type: "boolean" },
       chatgpt: { type: "boolean" },
       codex: { type: "boolean" },
+      all: { type: "boolean" },
       project: { type: "boolean" },
       force: { type: "boolean" },
       help: { type: "boolean", short: "h" },
@@ -270,10 +367,9 @@ export function main(argv = process.argv.slice(2)) {
   if (values.help || !command) return log(HELP);
 
   const opts = { project: Boolean(values.project), force: Boolean(values.force) };
-  const targets = pickTargets(values);
 
   if (command === "install") {
-    for (const t of targets) t.install(opts);
+    for (const t of await pickInstallTargets(values)) t.install(opts);
     const py = pythonCheck();
     if (!py.ok) {
       log();
@@ -282,9 +378,13 @@ export function main(argv = process.argv.slice(2)) {
     }
     log();
     log(`Your résumé, profile and application history are stored locally in ~/Documents/Job Apply.`);
-  } else if (command === "uninstall") {
+  } else if (command === "uninstall" || command === "remove") {
+    const targets = await pickUninstallTargets(values, opts);
+    if (targets.length === 0) return;
     for (const t of targets) t.uninstall(opts);
-    log(`Your local profile in ~/Documents/Job Apply was not touched.`);
+    log();
+    log(`Your résumé, profile and history in ~/Documents/Job Apply were kept.`);
+    log(`To erase them too, delete that folder or ask the assistant to "clear my Job Apply profile" before uninstalling.`);
   } else if (command === "status") {
     for (const t of Object.values(TARGETS)) log(`${t.label.padEnd(24)} ${t.status(opts)}`);
     const py = pythonCheck();
@@ -296,13 +396,11 @@ export function main(argv = process.argv.slice(2)) {
 
 const invokedDirectly = process.argv[1] && fs.realpathSync(process.argv[1]) === fileURLToPath(import.meta.url);
 if (invokedDirectly) {
-  try {
-    main();
-  } catch (err) {
+  main().catch((err) => {
     if (err instanceof CliError || err?.code?.startsWith?.("ERR_PARSE_ARGS")) {
       process.stderr.write(`✖ ${err.message}\n`);
       process.exit(1);
     }
     throw err;
-  }
+  });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-apply-plugin",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Job Apply plugin for Claude Code and ChatGPT/Codex: prepare and submit job applications from a résumé and profile saved on your device.",
   "keywords": [
     "claude",
@@ -14,6 +14,14 @@
     "resume"
   ],
   "author": "Filipe Linemburger",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/filipelinemburger/job-apply.git"
+  },
+  "homepage": "https://github.com/filipelinemburger/job-apply#readme",
+  "bugs": {
+    "url": "https://github.com/filipelinemburger/job-apply/issues"
+  },
   "type": "module",
   "bin": {
     "job-apply-plugin": "bin/job-apply.js"

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "job-apply",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
   "author": {
     "name": "Filipe Linemburger"

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "job-apply",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
   "keywords": [
     "jobs",