terminalhire 0.1.0 → 0.1.1

package/dist/bin/jpi-config.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+// bin/jpi-config.js
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var TERMINALHIRE_DIR = join(homedir(), ".terminalhire");
+var CONFIG_FILE = join(TERMINALHIRE_DIR, "config.json");
+var DEFAULT_CONFIG = { nudge: "session" };
+function readConfig() {
+  try {
+    if (!existsSync(CONFIG_FILE)) return { ...DEFAULT_CONFIG };
+    return { ...DEFAULT_CONFIG, ...JSON.parse(readFileSync(CONFIG_FILE, "utf8")) };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+function writeConfig(patch) {
+  mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+  const merged = { ...readConfig(), ...patch };
+  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", "utf8");
+}
+function parseNudgeMode(raw) {
+  if (raw === "session" || raw === "always") return raw;
+  const m = /^every:(\d+)$/.exec(raw);
+  if (m && parseInt(m[1], 10) >= 1) return raw;
+  return null;
+}
+async function run() {
+  const args = process.argv.slice(2);
+  const filtered = args[0] === "config" ? args.slice(1) : args;
+  if (filtered.includes("--show") || filtered.length === 0) {
+    const cfg = readConfig();
+    const envOverride = process.env["TERMINALHIRE_NUDGE"];
+    console.log("");
+    console.log("terminalhire config");
+    console.log("");
+    console.log(`  nudge: ${cfg.nudge}`);
+    if (envOverride) {
+      console.log(`  (overridden by TERMINALHIRE_NUDGE=${envOverride} at runtime)`);
+    }
+    console.log(`  config file: ${CONFIG_FILE}`);
+    console.log("");
+    console.log("  Valid nudge values:");
+    console.log("    session   \u2014 print at most once per Claude Code session (default)");
+    console.log("    always    \u2014 print every statusLine render when matches exist");
+    console.log("    every:N   \u2014 print every Nth render (e.g. every:3)");
+    console.log("");
+    return;
+  }
+  const nudgeIdx = filtered.indexOf("--nudge");
+  if (nudgeIdx !== -1) {
+    const value = filtered[nudgeIdx + 1];
+    if (!value) {
+      console.error("Error: --nudge requires a value: session | always | every:N");
+      process.exit(1);
+    }
+    const parsed = parseNudgeMode(value);
+    if (!parsed) {
+      console.error(`Error: invalid nudge value "${value}". Valid: session | always | every:N`);
+      process.exit(1);
+    }
+    writeConfig({ nudge: parsed });
+    console.log(`  nudge set to: ${parsed}`);
+    console.log(`  (saved to ${CONFIG_FILE})`);
+    return;
+  }
+  console.error("Usage: terminalhire config --nudge <session|always|every:N>");
+  console.error("       terminalhire config --show");
+  process.exit(1);
+}
+export {
+  run
+};

package/dist/bin/jpi-dispatch.js

@@ -202,7 +202,7 @@ async function resolveStoredLogin() {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 var TERMINALHIRE_DIR, TOKEN_FILE, KEY_FILE, ALGO, KEY_BYTES, IV_BYTES, GITHUB_SCOPE, DEVICE_CODE_URL, ACCESS_TOKEN_URL, DEV_PLACEHOLDER_CLIENT_ID, MOCK_TOKEN, MOCK_LOGIN;
 var init_github_auth = __esm({
@@ -1529,12 +1529,12 @@ async function runLogin() {
     let ghProfile;
     if (process.env["TERMINALHIRE_GITHUB_MOCK"] === "1" || process.env["TERMINALHIRE_GITHUB_MOCK"] === "1" || process.env["JPI_GITHUB_MOCK"] === "1") {
       const { createRequire: createRequire2 } = await import("module");
-      const { fileURLToPath: fileURLToPath4 } = await import("url");
-      const { join: join7, dirname } = await import("path");
-      const __dirname3 = fileURLToPath4(new URL(".", import.meta.url));
-      const fixturePath = join7(__dirname3, "../../fixtures/github-sample.json");
-      const { readFileSync: readFileSync7 } = await import("fs");
-      ghProfile = JSON.parse(readFileSync7(fixturePath, "utf8"));
+      const { fileURLToPath: fileURLToPath5 } = await import("url");
+      const { join: join9, dirname: dirname2 } = await import("path");
+      const __dirname4 = fileURLToPath5(new URL(".", import.meta.url));
+      const fixturePath = join9(__dirname4, "../../fixtures/github-sample.json");
+      const { readFileSync: readFileSync8 } = await import("fs");
+      ghProfile = JSON.parse(readFileSync8(fixturePath, "utf8"));
     } else {
       ghProfile = await fetchGitHubProfile2(login, token);
     }
@@ -1645,10 +1645,10 @@ async function fetchIndex() {
 }
 function prompt(question) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim().toLowerCase());
+      resolve2(answer.trim().toLowerCase());
     });
   });
 }
@@ -1846,10 +1846,10 @@ __export(jpi_profile_exports, {
 import { createInterface as createInterface2 } from "readline";
 function prompt2(question) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     });
   });
 }
@@ -2195,16 +2195,244 @@ var init_jpi_learn = __esm({
   }
 });
 
-// bin/jpi-dispatch.js
-import { fileURLToPath as fileURLToPath3 } from "url";
+// bin/jpi-config.js
+var jpi_config_exports = {};
+__export(jpi_config_exports, {
+  run: () => run5
+});
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, existsSync as existsSync4 } from "fs";
 import { join as join6 } from "path";
-import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
+import { homedir as homedir4 } from "os";
+function readConfig() {
+  try {
+    if (!existsSync4(CONFIG_FILE)) return { ...DEFAULT_CONFIG };
+    return { ...DEFAULT_CONFIG, ...JSON.parse(readFileSync6(CONFIG_FILE, "utf8")) };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+function writeConfig(patch) {
+  mkdirSync4(TERMINALHIRE_DIR4, { recursive: true });
+  const merged = { ...readConfig(), ...patch };
+  writeFileSync4(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", "utf8");
+}
+function parseNudgeMode(raw) {
+  if (raw === "session" || raw === "always") return raw;
+  const m = /^every:(\d+)$/.exec(raw);
+  if (m && parseInt(m[1], 10) >= 1) return raw;
+  return null;
+}
+async function run5() {
+  const args2 = process.argv.slice(2);
+  const filtered = args2[0] === "config" ? args2.slice(1) : args2;
+  if (filtered.includes("--show") || filtered.length === 0) {
+    const cfg = readConfig();
+    const envOverride = process.env["TERMINALHIRE_NUDGE"];
+    console.log("");
+    console.log("terminalhire config");
+    console.log("");
+    console.log(`  nudge: ${cfg.nudge}`);
+    if (envOverride) {
+      console.log(`  (overridden by TERMINALHIRE_NUDGE=${envOverride} at runtime)`);
+    }
+    console.log(`  config file: ${CONFIG_FILE}`);
+    console.log("");
+    console.log("  Valid nudge values:");
+    console.log("    session   \u2014 print at most once per Claude Code session (default)");
+    console.log("    always    \u2014 print every statusLine render when matches exist");
+    console.log("    every:N   \u2014 print every Nth render (e.g. every:3)");
+    console.log("");
+    return;
+  }
+  const nudgeIdx = filtered.indexOf("--nudge");
+  if (nudgeIdx !== -1) {
+    const value = filtered[nudgeIdx + 1];
+    if (!value) {
+      console.error("Error: --nudge requires a value: session | always | every:N");
+      process.exit(1);
+    }
+    const parsed = parseNudgeMode(value);
+    if (!parsed) {
+      console.error(`Error: invalid nudge value "${value}". Valid: session | always | every:N`);
+      process.exit(1);
+    }
+    writeConfig({ nudge: parsed });
+    console.log(`  nudge set to: ${parsed}`);
+    console.log(`  (saved to ${CONFIG_FILE})`);
+    return;
+  }
+  console.error("Usage: terminalhire config --nudge <session|always|every:N>");
+  console.error("       terminalhire config --show");
+  process.exit(1);
+}
+var TERMINALHIRE_DIR4, CONFIG_FILE, DEFAULT_CONFIG;
+var init_jpi_config = __esm({
+  "bin/jpi-config.js"() {
+    "use strict";
+    TERMINALHIRE_DIR4 = join6(homedir4(), ".terminalhire");
+    CONFIG_FILE = join6(TERMINALHIRE_DIR4, "config.json");
+    DEFAULT_CONFIG = { nudge: "session" };
+  }
+});
+
+// bin/jpi-init.js
+var jpi_init_exports = {};
+__export(jpi_init_exports, {
+  run: () => run6
+});
+import { existsSync as existsSync5 } from "fs";
+import { join as join7, resolve } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { createInterface as createInterface3 } from "readline";
+import { spawnSync, spawn } from "child_process";
+import { homedir as homedir5 } from "os";
+function ask(question) {
+  const rl = createInterface3({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim().toLowerCase());
+    });
+  });
+}
+function resolveScript(name) {
+  const distPath = resolve(join7(__dirname2, "..", "..", "dist", "bin", `${name}.js`));
+  const legacyPath = resolve(join7(__dirname2, `${name}.js`));
+  return existsSync5(distPath) ? distPath : legacyPath;
+}
+function resolveInstallJs() {
+  const fromDist = resolve(join7(__dirname2, "..", "..", "install.js"));
+  const fromBin = resolve(join7(__dirname2, "..", "install.js"));
+  if (existsSync5(fromDist)) return fromDist;
+  if (existsSync5(fromBin)) return fromBin;
+  return fromBin;
+}
+async function run6() {
+  console.log("");
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502           terminalhire init \u2014 one-command onboarding            \u2502");
+  console.log("\u2502       Local-first job matching for developers in Claude Code     \u2502");
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log("");
+  console.log("This will:");
+  console.log("  1. Optionally sign you in with GitHub (public profile only, read:user)");
+  console.log("  2. Seed your local job cache (anonymous index download)");
+  console.log("  3. Install the statusLine hook in ~/.claude/settings.json");
+  console.log("     (with backup + your explicit consent before any file is touched)");
+  console.log("");
+  console.log('You can stop at any step. Nothing is changed until you say "yes".');
+  console.log("");
+  console.log("Step 1/3 \u2014 GitHub sign-in (optional but recommended)");
+  console.log("");
+  console.log("  Scope: read:user \u2014 public profile + public repos only.");
+  console.log("  Your token is encrypted at ~/.terminalhire/github-token.enc.");
+  console.log("  GitHub data enriches your local profile. Nothing leaves your machine");
+  console.log("  until you explicitly consent to a specific lead.");
+  console.log("");
+  const githubAnswer = await ask("Sign in with GitHub now? [Y/n] (Enter = yes, n = stay local): ");
+  const doGitHub = githubAnswer === "" || githubAnswer === "y" || githubAnswer === "yes";
+  if (doGitHub) {
+    console.log("");
+    console.log("  Starting GitHub device flow...");
+    const loginScript = resolveScript("jpi-login");
+    const child = spawnSync(process.execPath, [loginScript, "login"], {
+      stdio: ["inherit", "inherit", "inherit"],
+      env: process.env
+    });
+    if (child.status !== 0) {
+      console.log("");
+      console.log("  GitHub sign-in did not complete. Continuing without GitHub.");
+      console.log("  You can sign in any time with: terminalhire login");
+    }
+  } else {
+    console.log("");
+    console.log("  Staying local-only. Tags accumulate from your personal project sessions.");
+    console.log("  Sign in any time with: terminalhire login");
+  }
+  console.log("");
+  console.log("Step 2/3 \u2014 Seeding local job cache");
+  console.log("");
+  console.log("  Fetching anonymous job index (no dev data sent)...");
+  const jobsScript = resolveScript("jpi-jobs");
+  const seedChild = spawnSync(
+    process.execPath,
+    [jobsScript, "--limit", "0"],
+    {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, TERMINALHIRE_SEED_ONLY: "1" },
+      timeout: 15e3
+    }
+  );
+  if (seedChild.status === 0) {
+    console.log("  Job cache seeded successfully.");
+  } else {
+    console.log("  Could not seed job cache right now (no profile tags yet, or offline).");
+    console.log("  Run `terminalhire jobs` after a few Claude Code sessions to populate it.");
+  }
+  console.log("");
+  console.log("Step 3/3 \u2014 Install statusLine hook in ~/.claude/settings.json");
+  console.log("");
+  console.log("  This is the only step that modifies a system file.");
+  console.log("  A timestamped backup is created before any change.");
+  console.log("  Uninstall at any time: node install.js --uninstall");
+  console.log("");
+  const installJs = resolveInstallJs();
+  const installChild = spawnSync(process.execPath, [installJs], {
+    stdio: ["inherit", "inherit", "inherit"],
+    env: process.env
+  });
+  if (installChild.status !== 0) {
+    console.log("");
+    console.log("  Hook installation did not complete. Run manually: node install.js");
+  }
+  console.log("");
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502  terminalhire init complete!                                    \u2502");
+  console.log("\u2502                                                                  \u2502");
+  console.log("\u2502  Restart Claude Code to see the statusLine nudge.               \u2502");
+  console.log("\u2502                                                                  \u2502");
+  console.log("\u2502  Quick reference:                                               \u2502");
+  console.log("\u2502    terminalhire jobs          \u2014 browse matching roles           \u2502");
+  console.log("\u2502    terminalhire config --show \u2014 view nudge settings             \u2502");
+  console.log("\u2502    terminalhire login         \u2014 sign in with GitHub             \u2502");
+  console.log("\u2502    terminalhire profile --show \u2014 inspect your local profile     \u2502");
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log("");
+}
+var __dirname2;
+var init_jpi_init = __esm({
+  "bin/jpi-init.js"() {
+    "use strict";
+    __dirname2 = fileURLToPath3(new URL(".", import.meta.url));
+  }
+});
+
+// bin/jpi-dispatch.js
+import { fileURLToPath as fileURLToPath4 } from "url";
+import { join as join8, dirname } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
 import { createRequire } from "module";
-var __dirname2 = fileURLToPath3(new URL(".", import.meta.url));
+var __dirname3 = fileURLToPath4(new URL(".", import.meta.url));
+function readPackageVersion() {
+  try {
+    const candidates = [
+      join8(__dirname3, "..", "..", "package.json"),
+      join8(__dirname3, "..", "package.json")
+    ];
+    for (const p of candidates) {
+      if (existsSync6(p)) {
+        const pkg = JSON.parse(readFileSync7(p, "utf8"));
+        if (pkg.version) return pkg.version;
+      }
+    }
+  } catch {
+  }
+  return "0.1.1";
+}
 var firstArg = process.argv[2];
 if (!firstArg && !process.stdin.isTTY) {
   const { default: childProcess } = await import("child_process");
-  const nudgeScript = join6(__dirname2, "jpi.js");
+  const nudgeScript = join8(__dirname3, "jpi.js");
   const child = childProcess.spawnSync(process.execPath, [nudgeScript], {
     stdio: ["inherit", "inherit", "inherit"]
   });
@@ -2212,21 +2440,27 @@ if (!firstArg && !process.stdin.isTTY) {
 }
 if (!firstArg || firstArg === "help" || firstArg === "--help" || firstArg === "-h") {
   console.log("");
-  console.log("terminalhire v3.1 \u2014 local-first job matching for developers");
+  console.log(`terminalhire v${readPackageVersion()} \u2014 local-first job matching for developers`);
   console.log("");
   console.log("Commands:");
-  console.log("  terminalhire login            Sign in with GitHub (recommended \u2014 enriches profile instantly)");
-  console.log("  terminalhire logout           Clear stored GitHub token");
-  console.log("  terminalhire jobs             Fetch job index, match locally, browse roles");
-  console.log("  terminalhire jobs --limit N   Show top N results (default: 10)");
-  console.log("  terminalhire jobs --remote-only  Filter to remote roles only");
-  console.log("  terminalhire profile --show   Display your encrypted local profile");
-  console.log("  terminalhire profile --edit   Set displayName, contactEmail, prefs");
-  console.log("  terminalhire profile --delete Wipe profile and encryption key from disk");
+  console.log("  terminalhire init                           One-command onboarding (start here)");
+  console.log("  terminalhire login                          Sign in with GitHub (enriches profile instantly)");
+  console.log("  terminalhire logout                         Clear stored GitHub token");
+  console.log("  terminalhire jobs                           Fetch job index, match locally, browse roles");
+  console.log("  terminalhire jobs --limit N                 Show top N results (default: 10)");
+  console.log("  terminalhire jobs --remote-only             Filter to remote roles only");
+  console.log("  terminalhire profile --show                 Display your encrypted local profile");
+  console.log("  terminalhire profile --edit                 Set displayName, contactEmail, prefs");
+  console.log("  terminalhire profile --delete               Wipe profile and encryption key from disk");
+  console.log("  terminalhire config --nudge session         Nudge at most once per session (default)");
+  console.log("  terminalhire config --nudge always          Nudge every statusLine render");
+  console.log("  terminalhire config --nudge every:N         Nudge every Nth render");
+  console.log("  terminalhire config --show                  Print current config");
   console.log("");
   console.log("Install / uninstall the Claude Code statusLine nudge:");
-  console.log("  node install.js");
-  console.log("  node install.js --uninstall");
+  console.log("  terminalhire init               (preferred \u2014 full guided onboarding)");
+  console.log("  node install.js                 (manual install)");
+  console.log("  node install.js --uninstall     (manual uninstall)");
   console.log("");
   console.log("Privacy: your profile never leaves your device.");
   console.log("  GET /api/index   \u2014 anonymous index download (no dev data)");
@@ -2236,7 +2470,7 @@ if (!firstArg || firstArg === "help" || firstArg === "--help" || firstArg === "-
   process.exit(0);
 }
 if (firstArg === "--version" || firstArg === "-v") {
-  console.log("terminalhire v3.1.0");
+  console.log(`terminalhire v${readPackageVersion()}`);
   process.exit(0);
 }
 if (firstArg === "login" || firstArg === "logout") {
@@ -2260,5 +2494,15 @@ if (firstArg === "learn") {
   await mod.run();
   process.exit(0);
 }
+if (firstArg === "config") {
+  const mod = await Promise.resolve().then(() => (init_jpi_config(), jpi_config_exports));
+  await mod.run();
+  process.exit(0);
+}
+if (firstArg === "init") {
+  const mod = await Promise.resolve().then(() => (init_jpi_init(), jpi_init_exports));
+  await mod.run();
+  process.exit(0);
+}
 console.error(`terminalhire: unknown command '${firstArg}'. Run 'terminalhire help' for usage.`);
 process.exit(1);

package/dist/bin/jpi-init.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+
+// bin/jpi-init.js
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { createInterface } from "readline";
+import { spawnSync, spawn } from "child_process";
+import { homedir } from "os";
+var __dirname = fileURLToPath(new URL(".", import.meta.url));
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim().toLowerCase());
+    });
+  });
+}
+function resolveScript(name) {
+  const distPath = resolve(join(__dirname, "..", "..", "dist", "bin", `${name}.js`));
+  const legacyPath = resolve(join(__dirname, `${name}.js`));
+  return existsSync(distPath) ? distPath : legacyPath;
+}
+function resolveInstallJs() {
+  const fromDist = resolve(join(__dirname, "..", "..", "install.js"));
+  const fromBin = resolve(join(__dirname, "..", "install.js"));
+  if (existsSync(fromDist)) return fromDist;
+  if (existsSync(fromBin)) return fromBin;
+  return fromBin;
+}
+async function run() {
+  console.log("");
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502           terminalhire init \u2014 one-command onboarding            \u2502");
+  console.log("\u2502       Local-first job matching for developers in Claude Code     \u2502");
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log("");
+  console.log("This will:");
+  console.log("  1. Optionally sign you in with GitHub (public profile only, read:user)");
+  console.log("  2. Seed your local job cache (anonymous index download)");
+  console.log("  3. Install the statusLine hook in ~/.claude/settings.json");
+  console.log("     (with backup + your explicit consent before any file is touched)");
+  console.log("");
+  console.log('You can stop at any step. Nothing is changed until you say "yes".');
+  console.log("");
+  console.log("Step 1/3 \u2014 GitHub sign-in (optional but recommended)");
+  console.log("");
+  console.log("  Scope: read:user \u2014 public profile + public repos only.");
+  console.log("  Your token is encrypted at ~/.terminalhire/github-token.enc.");
+  console.log("  GitHub data enriches your local profile. Nothing leaves your machine");
+  console.log("  until you explicitly consent to a specific lead.");
+  console.log("");
+  const githubAnswer = await ask("Sign in with GitHub now? [Y/n] (Enter = yes, n = stay local): ");
+  const doGitHub = githubAnswer === "" || githubAnswer === "y" || githubAnswer === "yes";
+  if (doGitHub) {
+    console.log("");
+    console.log("  Starting GitHub device flow...");
+    const loginScript = resolveScript("jpi-login");
+    const child = spawnSync(process.execPath, [loginScript, "login"], {
+      stdio: ["inherit", "inherit", "inherit"],
+      env: process.env
+    });
+    if (child.status !== 0) {
+      console.log("");
+      console.log("  GitHub sign-in did not complete. Continuing without GitHub.");
+      console.log("  You can sign in any time with: terminalhire login");
+    }
+  } else {
+    console.log("");
+    console.log("  Staying local-only. Tags accumulate from your personal project sessions.");
+    console.log("  Sign in any time with: terminalhire login");
+  }
+  console.log("");
+  console.log("Step 2/3 \u2014 Seeding local job cache");
+  console.log("");
+  console.log("  Fetching anonymous job index (no dev data sent)...");
+  const jobsScript = resolveScript("jpi-jobs");
+  const seedChild = spawnSync(
+    process.execPath,
+    [jobsScript, "--limit", "0"],
+    {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, TERMINALHIRE_SEED_ONLY: "1" },
+      timeout: 15e3
+    }
+  );
+  if (seedChild.status === 0) {
+    console.log("  Job cache seeded successfully.");
+  } else {
+    console.log("  Could not seed job cache right now (no profile tags yet, or offline).");
+    console.log("  Run `terminalhire jobs` after a few Claude Code sessions to populate it.");
+  }
+  console.log("");
+  console.log("Step 3/3 \u2014 Install statusLine hook in ~/.claude/settings.json");
+  console.log("");
+  console.log("  This is the only step that modifies a system file.");
+  console.log("  A timestamped backup is created before any change.");
+  console.log("  Uninstall at any time: node install.js --uninstall");
+  console.log("");
+  const installJs = resolveInstallJs();
+  const installChild = spawnSync(process.execPath, [installJs], {
+    stdio: ["inherit", "inherit", "inherit"],
+    env: process.env
+  });
+  if (installChild.status !== 0) {
+    console.log("");
+    console.log("  Hook installation did not complete. Run manually: node install.js");
+  }
+  console.log("");
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502  terminalhire init complete!                                    \u2502");
+  console.log("\u2502                                                                  \u2502");
+  console.log("\u2502  Restart Claude Code to see the statusLine nudge.               \u2502");
+  console.log("\u2502                                                                  \u2502");
+  console.log("\u2502  Quick reference:                                               \u2502");
+  console.log("\u2502    terminalhire jobs          \u2014 browse matching roles           \u2502");
+  console.log("\u2502    terminalhire config --show \u2014 view nudge settings             \u2502");
+  console.log("\u2502    terminalhire login         \u2014 sign in with GitHub             \u2502");
+  console.log("\u2502    terminalhire profile --show \u2014 inspect your local profile     \u2502");
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log("");
+}
+export {
+  run
+};

package/dist/bin/jpi.js

@@ -9,6 +9,7 @@ import { spawn } from "child_process";
 var TERMINALHIRE_DIR = join(homedir(), ".terminalhire");
 var INDEX_CACHE_FILE = join(TERMINALHIRE_DIR, "index-cache.json");
 var NUDGE_FILE = join(TERMINALHIRE_DIR, "nudged.json");
+var NUDGE_COUNTER_FILE = join(TERMINALHIRE_DIR, "nudge-counter.json");
 var LEARNED_FILE = join(TERMINALHIRE_DIR, "learned-sessions.json");
 var INDEX_CACHE_TTL_MS = 15 * 60 * 1e3;
 var __dirname = fileURLToPath(new URL(".", import.meta.url));
@@ -82,6 +83,66 @@ function getCachedMatchCount() {
     return null;
   }
 }
+function getNudgeMode() {
+  const envVal = process.env["TERMINALHIRE_NUDGE"];
+  if (envVal) {
+    const parsed = parseNudgeMode(envVal);
+    if (parsed) return parsed;
+  }
+  try {
+    const configFile = join(TERMINALHIRE_DIR, "config.json");
+    if (existsSync(configFile)) {
+      const cfg = JSON.parse(readFileSync(configFile, "utf8"));
+      if (cfg.nudge) {
+        const parsed = parseNudgeMode(cfg.nudge);
+        if (parsed) return parsed;
+      }
+    }
+  } catch {
+  }
+  return "session";
+}
+function parseNudgeMode(raw) {
+  if (raw === "session" || raw === "always") return raw;
+  const m = /^every:(\d+)$/.exec(raw);
+  if (m) {
+    const n = parseInt(m[1], 10);
+    if (n >= 1) return `every:${n}`;
+  }
+  return null;
+}
+function bumpRenderCounter() {
+  try {
+    mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+    let counter = 0;
+    if (existsSync(NUDGE_COUNTER_FILE)) {
+      const raw = JSON.parse(readFileSync(NUDGE_COUNTER_FILE, "utf8"));
+      counter = typeof raw.count === "number" ? raw.count : 0;
+    }
+    counter++;
+    writeFileSync(NUDGE_COUNTER_FILE, JSON.stringify({ count: counter }), "utf8");
+    return counter;
+  } catch {
+    return 1;
+  }
+}
+function shouldNudge(nudgeMode, sessionId) {
+  if (nudgeMode === "always") {
+    return true;
+  }
+  if (nudgeMode === "session") {
+    const nudged2 = readNudged();
+    return !nudged2[sessionId];
+  }
+  const m = /^every:(\d+)$/.exec(nudgeMode);
+  if (m) {
+    const n = parseInt(m[1], 10);
+    const count = bumpRenderCounter();
+    return count % n === 0;
+  }
+  const nudged = readNudged();
+  return !nudged[sessionId];
+}
 try {
   const input = readStdinSync();
   const sessionId = input?.session_id;
@@ -92,14 +153,16 @@ try {
     spawnLearnDetached(workDir);
     markLearned(sessionId);
   }
-  const nudged = readNudged();
-  if (nudged[sessionId]) process.exit(0);
   const matchCount = getCachedMatchCount();
   if (matchCount === null || matchCount === 0) process.exit(0);
+  const nudgeMode = getNudgeMode();
+  if (!shouldNudge(nudgeMode, sessionId)) process.exit(0);
   const plural = matchCount === 1 ? "role" : "roles";
   process.stdout.write(`\u2726 ${matchCount} ${plural} match your current work \u2014 run: terminalhire jobs
 `);
-  markNudged(sessionId);
+  if (nudgeMode === "session") {
+    markNudged(sessionId);
+  }
   process.exit(0);
 } catch {
   process.exit(0);

package/dist/src/config.js

@@ -0,0 +1,49 @@
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var TERMINALHIRE_DIR = join(homedir(), ".terminalhire");
+var CONFIG_FILE = join(TERMINALHIRE_DIR, "config.json");
+var DEFAULT_CONFIG = {
+  nudge: "session"
+};
+function readConfig() {
+  try {
+    if (!existsSync(CONFIG_FILE)) return { ...DEFAULT_CONFIG };
+    const raw = readFileSync(CONFIG_FILE, "utf8");
+    const parsed = JSON.parse(raw);
+    return { ...DEFAULT_CONFIG, ...parsed };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+function writeConfig(config) {
+  mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+  const current = readConfig();
+  const merged = { ...current, ...config };
+  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", "utf8");
+}
+function parseNudgeMode(raw) {
+  if (raw === "session" || raw === "always") return raw;
+  const m = /^every:(\d+)$/.exec(raw);
+  if (m) {
+    const n = parseInt(m[1], 10);
+    if (n >= 1) return `every:${n}`;
+  }
+  return null;
+}
+function getNudgeMode() {
+  const envVal = process.env["TERMINALHIRE_NUDGE"];
+  if (envVal) {
+    const parsed = parseNudgeMode(envVal);
+    if (parsed) return parsed;
+  }
+  const config = readConfig();
+  return config.nudge ?? "session";
+}
+export {
+  getNudgeMode,
+  parseNudgeMode,
+  readConfig,
+  writeConfig
+};

package/install.js

@@ -1,14 +1,25 @@
 #!/usr/bin/env node
 /**
- * install.js — v3 installer for jpi
+ * install.js — v3.1 installer for terminalhire
+ *
+ * ToS / safety guardrails (binding — see CONSTITUTION.md Rule 7 and Rule 12):
+ *   - ONLY uses the official Claude Code `statusLine` settings.json hook.
+ *   - NEVER silently modifies ~/.claude/settings.json.
+ *   - Always backs up settings.json (timestamped) before any write.
+ *   - Prints a clear disclosure of exactly what it changed.
+ *   - Provides one-command uninstall that restores the backup.
+ *   - CHAIN, never clobber: if a statusLine already exists that is NOT ours,
+ *     creates a wrapper script that runs BOTH commands, then points settings.json
+ *     at the wrapper. Idempotent — detects existing wrapper and does not double-wrap.
+ *   - postinstall (not this file) is print-only and never calls this file.
  *
  * What it does:
- *   1. Prints a full v3 disclosure (local-first, pull model, named buyer, lead payload)
+ *   1. Prints full v3 disclosure
  *   2. Requires explicit "yes" before touching any system file
- *   3. Backs up ~/.claude/settings.json
- *   4. Merges a statusLine entry pointing to bin/jpi.js (nudge only, no egress)
- *   5. Registers 'jpi' bin in PATH if npm global bin is writable
- *   6. Supports --uninstall
+ *   3. Backs up ~/.claude/settings.json (timestamped)
+ *   4. If no existing statusLine → sets terminalhire's nudge directly
+ *      If existing statusLine (not ours) → builds a wrapper that chains both
+ *   5. Supports --uninstall (restores the backup / removes wrapper)
  *   7. Idempotent: safe to run multiple times
  *
  * Usage:
@@ -16,7 +27,10 @@
  *   node install.js --uninstall
  */
 
-import { readFileSync, writeFileSync, copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import {
+  readFileSync, writeFileSync, copyFileSync, existsSync,
+  mkdirSync, chmodSync, readdirSync,
+} from 'node:fs';
 import { homedir } from 'node:os';
 import { join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -24,15 +38,26 @@ import { createInterface } from 'node:readline';
 import { spawnSync } from 'node:child_process';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
+
 // Resolve the nudge bin robustly: prefer the bundled dist output (published package),
 // fall back to the legacy bin/ path for in-workspace / development installs.
 const _distBin = resolve(join(__dirname, 'dist', 'bin', 'jpi.js'));
 const _legacyBin = resolve(join(__dirname, 'bin', 'jpi.js'));
 const BIN_PATH = existsSync(_distBin) ? _distBin : _legacyBin;
+
 const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
 const SETTINGS_DIR = dirname(SETTINGS_PATH);
+const TERMINALHIRE_DIR = join(homedir(), '.terminalhire');
+const WRAPPER_PATH = join(TERMINALHIRE_DIR, 'statusline-wrapper.sh');
+
+// The existing statusLine command on the user's machine that we must preserve
+const KNOWN_EXISTING_STATUSLINE = 'bash /Users/ericgang/.claude/statusline-command.sh';
+
 const UNINSTALL = process.argv.includes('--uninstall');
 
+// ── Sentinel comment embedded in the wrapper so we can detect our own wrappers
+const WRAPPER_SENTINEL = '# terminalhire-wrapper-v1';
+
 // ── Helpers ───────────────────────────────────────────────────────────────────
 
 function readSettings() {
@@ -47,11 +72,12 @@ function readSettings() {
 }
 
 function backupSettings() {
-  if (!existsSync(SETTINGS_PATH)) return;
+  if (!existsSync(SETTINGS_PATH)) return null;
   const ts = new Date().toISOString().replace(/[:.]/g, '-');
   const backupPath = `${SETTINGS_PATH}.terminalhire-backup-${ts}`;
   copyFileSync(SETTINGS_PATH, backupPath);
   console.log(`  Backed up settings to: ${backupPath}`);
+  return backupPath;
 }
 
 function writeSettings(settings) {
@@ -61,24 +87,95 @@ function writeSettings(settings) {
 
 function ask(question) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(resolve => {
+  return new Promise(res => {
     rl.question(question, answer => {
       rl.close();
-      resolve(answer.trim().toLowerCase());
+      res(answer.trim().toLowerCase());
     });
   });
 }
 
-function buildStatusLineEntry(binPath) {
+/** Build the direct (no-chain) statusLine entry for terminalhire. */
+function buildDirectEntry(binPath) {
   return `node ${binPath}`;
 }
 
+/**
+ * Returns true if the given statusLine value is terminalhire's own entry:
+ * either the direct node entry or our wrapper script.
+ */
+function isOurEntry(statusLine) {
+  if (!statusLine) return false;
+  // Direct entry
+  if (statusLine === buildDirectEntry(BIN_PATH)) return true;
+  // Points at our wrapper
+  if (statusLine === `bash ${WRAPPER_PATH}`) return true;
+  // Wrapper exists and contains our sentinel
+  if (existsSync(WRAPPER_PATH)) {
+    try {
+      const wrapperContent = readFileSync(WRAPPER_PATH, 'utf8');
+      return wrapperContent.includes(WRAPPER_SENTINEL);
+    } catch { /* fall through */ }
+  }
+  return false;
+}
+
+/**
+ * Build the chaining wrapper shell script.
+ * Both the existing command and the terminalhire nudge receive the SAME stdin JSON.
+ * Output: existing command's output first, then terminalhire's output.
+ */
+function buildWrapper(existingCmd) {
+  return `#!/usr/bin/env bash
+${WRAPPER_SENTINEL}
+# Chains the original statusLine command with terminalhire's nudge.
+# Both receive the same stdin JSON. Original output prints first, then terminalhire.
+# Generated by: node install.js
+# Existing command: ${existingCmd}
+# terminalhire nudge: node ${BIN_PATH}
+
+# Read stdin once into a variable
+INPUT=$(cat)
+
+# Run the existing statusLine command
+EXISTING_OUT=$(printf '%s' "$INPUT" | ${existingCmd} 2>/dev/null || true)
+
+# Run terminalhire's nudge
+TH_OUT=$(printf '%s' "$INPUT" | node ${BIN_PATH} 2>/dev/null || true)
+
+# Print existing output (if any), then terminalhire output (if any)
+if [ -n "$EXISTING_OUT" ]; then
+  printf '%s\\n' "$EXISTING_OUT"
+fi
+if [ -n "$TH_OUT" ]; then
+  printf '%s\\n' "$TH_OUT"
+fi
+`;
+}
+
+/**
+ * Find the most recent terminalhire backup of settings.json.
+ * Returns the path or null.
+ */
+function findLatestBackup() {
+  try {
+    const files = readdirSync(SETTINGS_DIR)
+      .filter(f => f.startsWith('settings.json.terminalhire-backup-'))
+      .sort()
+      .reverse();
+    if (files.length === 0) return null;
+    return join(SETTINGS_DIR, files[0]);
+  } catch {
+    return null;
+  }
+}
+
 // ── Install ───────────────────────────────────────────────────────────────────
 
 async function install() {
   console.log('');
   console.log('┌─────────────────────────────────────────────────────────────────┐');
-  console.log('│             terminalhire v3.1 — local-first job matching         │');
+  console.log('│           terminalhire v0.1.1 — install statusLine hook         │');
   console.log('│          Pull your matches. Your profile stays on-device.       │');
   console.log('└─────────────────────────────────────────────────────────────────┘');
   console.log('');
@@ -88,8 +185,10 @@ async function install() {
   console.log('  1. `terminalhire jobs` downloads an anonymous job index from the server');
   console.log('     (GET /api/index — no dev data in the request).');
   console.log('  2. Matching runs LOCALLY against an encrypted profile on your device.');
-  console.log('  3. The status bar shows a once-per-session nudge if matches exist.');
-  console.log('     It reads nothing from disk and makes zero network calls.');
+  console.log('  3. The status bar shows a nudge when matches exist.');
+  console.log('     It reads only local files and makes zero network calls.');
+  console.log('  4. Nudge frequency: configurable via `terminalhire config --nudge`.');
+  console.log('     Default: once per session. Options: always | every:N.');
   console.log('');
   console.log('YOUR LOCAL PROFILE (~/.terminalhire/profile.enc):');
   console.log('  • Encrypted at rest with AES-256-GCM (Node built-in crypto).');
@@ -112,33 +211,6 @@ async function install() {
   console.log('  • GitHub data enriches your LOCAL profile — no data leaves the machine');
   console.log('    unless you consent to include GitHub fields in a specific terminalhire lead.');
   console.log('');
-  console.log('LEAD PAYLOAD (what is sent on consent — nothing else):');
-  console.log('  {');
-  console.log('    opportunityId,     // the specific job id you consented for');
-  console.log('    buyerId,           // "coastal"');
-  console.log('    buyerLegalName,    // "Coastal Recruiting LLC"');
-  console.log('    approvedFields: {');
-  console.log('      skillTags,       // your closed-vocab skill tags');
-  console.log('      seniorityBand,   // optional');
-  console.log('      displayName,     // optional, only if you set it in your profile');
-  console.log('      contactEmail,    // optional, only if you set it in your profile');
-  console.log('      note,            // optional, typed at consent time');
-  console.log('      github: {        // optional, ONLY if GitHub connected AND you say "yes"');
-  console.log('        login,         //   your GitHub username');
-  console.log('        profileUrl,    //   https://github.com/<login>');
-  console.log('        topLanguages,  //   top public repo languages');
-  console.log('        publicRepos,   //   public repo count');
-  console.log('      }');
-  console.log('    },');
-  console.log('    consentText,       // verbatim text you approved');
-  console.log('    createdAt          // ISO timestamp');
-  console.log('  }');
-  console.log('');
-  console.log('APPLY-DIRECT vs BUYER-LEAD:');
-  console.log('  Most roles in the index are "apply-direct" — jpi opens the employer URL.');
-  console.log('  NO data is sent for apply-direct roles. Only Coastal-repped roles');
-  console.log('  offer the named-entity consent flow.');
-  console.log('');
   console.log('HOW TO DISABLE / DELETE:');
   console.log('  • Uninstall statusLine:  node install.js --uninstall');
   console.log('  • Delete local profile:  terminalhire profile --delete');
@@ -146,75 +218,80 @@ async function install() {
   console.log('  • Wipe everything:       rm -rf ~/.terminalhire');
   console.log('');
 
-  const installAnswer = await ask('Install terminalhire v3.1? Type "yes" to continue: ');
+  const settings = readSettings();
+  const currentStatusLine = settings.statusLine;
+
+  // Already installed?
+  if (isOurEntry(currentStatusLine)) {
+    console.log('Already installed (statusLine is already terminalhire or our wrapper).');
+    console.log('');
+    console.log('To change nudge frequency: terminalhire config --nudge <session|always|every:N>');
+    console.log('To uninstall: node install.js --uninstall');
+    console.log('');
+    return;
+  }
+
+  // Determine install strategy
+  let installStrategy;
+  if (!currentStatusLine) {
+    installStrategy = 'direct';
+    console.log('  No existing statusLine found.');
+    console.log(`  Will set: statusLine = "node ${BIN_PATH}"`);
+  } else {
+    installStrategy = 'chain';
+    console.log(`  Existing statusLine detected: ${currentStatusLine}`);
+    console.log('  Will create a wrapper at: ~/.terminalhire/statusline-wrapper.sh');
+    console.log('  The wrapper runs BOTH commands (existing first, terminalhire second).');
+    console.log('  Both receive the same stdin JSON from Claude Code.');
+    console.log(`  Will set: statusLine = "bash ${WRAPPER_PATH}"`);
+  }
+  console.log('');
+
+  const installAnswer = await ask('Install terminalhire statusLine hook? Type "yes" to continue: ');
   if (installAnswer !== 'yes') {
     console.log('\nAborted — nothing was changed.');
     process.exit(0);
   }
 
   console.log('');
-  const settings = readSettings();
+  const backupPath = backupSettings();
 
-  if (settings.statusLine === buildStatusLineEntry(BIN_PATH)) {
-    console.log('Already installed.');
+  if (installStrategy === 'direct') {
+    settings.statusLine = buildDirectEntry(BIN_PATH);
+    writeSettings(settings);
+    console.log('  Set statusLine in ~/.claude/settings.json');
+    console.log(`    → node ${BIN_PATH}`);
   } else {
-    if (settings.statusLine) {
-      console.log(`  Note: replacing existing statusLine: ${settings.statusLine}`);
-    }
-    backupSettings();
-    settings.statusLine = buildStatusLineEntry(BIN_PATH);
+    // Write wrapper
+    mkdirSync(TERMINALHIRE_DIR, { recursive: true });
+    const wrapperContent = buildWrapper(currentStatusLine);
+    writeFileSync(WRAPPER_PATH, wrapperContent, 'utf8');
+    chmodSync(WRAPPER_PATH, 0o755);
+    console.log(`  Created wrapper: ${WRAPPER_PATH}`);
+
+    settings.statusLine = `bash ${WRAPPER_PATH}`;
     writeSettings(settings);
-    console.log('  Written statusLine to ~/.claude/settings.json');
+    console.log('  Updated statusLine in ~/.claude/settings.json');
+    console.log(`    → bash ${WRAPPER_PATH}`);
+    console.log('    (chains existing command + terminalhire nudge)');
   }
 
-  // ── GitHub onboarding step ─────────────────────────────────────────────────
-  console.log('');
-  console.log('┌─────────────────────────────────────────────────────────────────┐');
-  console.log('│  RECOMMENDED: Sign in with GitHub for instant, accurate matches │');
-  console.log('│                                                                  │');
-  console.log('│  terminalhire uses your PUBLIC GitHub profile (scope: read:user) to:│');
-  console.log('│   • Infer skill tags from public repo languages + topics         │');
-  console.log('│   • Estimate seniority from account age + contribution volume    │');
-  console.log('│   • Pre-fill identity fields (name, public email if set)         │');
-  console.log('│                                                                  │');
-  console.log('│  Your token is encrypted locally. No data leaves your machine   │');
-  console.log('│  until you explicitly consent to share it in a specific lead.   │');
-  console.log('│  Scope: read:user — public repos only. NEVER private repos.     │');
-  console.log('└─────────────────────────────────────────────────────────────────┘');
-  console.log('');
-
-  const githubAnswer = await ask(
-    'Sign in with GitHub now? [Y/n/skip] (Enter = yes, "skip" or "n" = stay local): '
-  );
-  const doGitHub = githubAnswer === '' || githubAnswer === 'y' || githubAnswer === 'yes';
-
-  if (doGitHub) {
-    console.log('');
-    console.log('  Starting GitHub device flow...');
-    const _loginDistPath = resolve(join(__dirname, 'dist', 'bin', 'jpi-login.js'));
-    const _loginLegacyPath = resolve(join(__dirname, 'bin', 'jpi-login.js'));
-    const loginScript = existsSync(_loginDistPath) ? _loginDistPath : _loginLegacyPath;
-    const child = spawnSync(process.execPath, [loginScript, 'login'], {
-      stdio: ['inherit', 'inherit', 'inherit'],
-      env: process.env,
-    });
-    if (child.status !== 0) {
-      console.log('');
-      console.log('  GitHub sign-in did not complete. You can run `terminalhire login` any time.');
-    }
-  } else {
-    console.log('');
-    console.log('  Staying local-only. You can sign in any time with: terminalhire login');
-    console.log('  Your profile will still accumulate tags from personal project sessions.');
+  if (backupPath) {
+    console.log(`  Backup: ${backupPath}`);
   }
 
   console.log('');
   console.log('Done. Restart Claude Code to activate the status bar nudge.');
   console.log('');
-  console.log('  Status bar format (once per session, only when matches exist):');
+  console.log('  Status bar format (default: once per session, only when matches exist):');
   console.log('    ✦ N roles match your current work — run: terminalhire jobs');
   console.log('');
-  console.log('  Commands:');
+  console.log('  Nudge frequency:');
+  console.log('    terminalhire config --nudge session   (default — once per session)');
+  console.log('    terminalhire config --nudge always    (every statusLine render)');
+  console.log('    terminalhire config --nudge every:N   (every Nth render)');
+  console.log('');
+  console.log('  Other commands:');
   console.log('    terminalhire login            — sign in with GitHub (enriches profile instantly)');
   console.log('    terminalhire logout           — clear GitHub token');
   console.log('    terminalhire jobs             — fetch index, match locally, browse roles');
@@ -239,24 +316,55 @@ async function uninstall() {
   }
 
   console.log(`  Current statusLine: ${settings.statusLine}`);
-  const answer = await ask('Remove this entry? Type "yes" to continue: ');
+
+  // Check if there is a backup to restore
+  const latestBackup = findLatestBackup();
+  if (latestBackup) {
+    console.log(`  Backup found: ${latestBackup}`);
+    console.log('  Uninstalling will restore this backup (restoring original statusLine).');
+  } else {
+    console.log('  No backup found — statusLine entry will be deleted (set to none).');
+  }
+  console.log('');
+
+  const answer = await ask('Uninstall terminalhire hook? Type "yes" to continue: ');
   if (answer !== 'yes') {
     console.log('\nAborted — nothing was changed.');
     process.exit(0);
   }
 
   console.log('');
-  backupSettings();
-  delete settings.statusLine;
-  writeSettings(settings);
 
-  console.log('  Removed statusLine from ~/.claude/settings.json');
+  if (latestBackup) {
+    // Restore the backup
+    copyFileSync(latestBackup, SETTINGS_PATH);
+    console.log(`  Restored settings from backup: ${latestBackup}`);
+  } else {
+    // Just remove the statusLine key
+    backupSettings();
+    delete settings.statusLine;
+    writeSettings(settings);
+    console.log('  Removed statusLine from ~/.claude/settings.json');
+  }
+
+  // Remove wrapper if it exists and is ours
+  if (existsSync(WRAPPER_PATH)) {
+    try {
+      const wrapperContent = readFileSync(WRAPPER_PATH, 'utf8');
+      if (wrapperContent.includes(WRAPPER_SENTINEL)) {
+        // We don't delete it automatically — user may have customized it
+        console.log(`  Wrapper file left in place: ${WRAPPER_PATH}`);
+        console.log('  (Remove manually if desired: rm ~/.terminalhire/statusline-wrapper.sh)');
+      }
+    } catch { /* ignore */ }
+  }
+
   console.log('');
   console.log('  Your profile is untouched. To also delete it:');
   console.log('    terminalhire profile --delete');
   console.log('    rm -rf ~/.terminalhire');
   console.log('');
-  console.log('Done.');
+  console.log('Done. Restart Claude Code to apply.');
   console.log('');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminalhire",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local-first job matching for developers — Claude Code statusLine integration",
   "type": "module",
   "engines": {
@@ -14,12 +14,14 @@
     "dist",
     "fixtures",
     "install.js",
+    "postinstall.js",
     "README.md"
   ],
   "scripts": {
     "build": "tsup",
     "prepublishOnly": "npm run build",
-    "install-hook": "node install.js"
+    "install-hook": "node install.js",
+    "postinstall": "node ./postinstall.js"
   },
   "publishConfig": {
     "access": "public"

package/postinstall.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * postinstall.js — print-only notice after `npm install terminalhire`
+ *
+ * ToS / safety guarantee:
+ *   - PRINT ONLY. No config edits. No network calls. No file writes.
+ *   - Always exits 0 (never fails the install).
+ *   - No-op if non-interactive / CI (TERM=dumb, CI=true, etc.).
+ */
+
+// Skip in CI / non-interactive environments
+const isCI =
+  process.env['CI'] === 'true' ||
+  process.env['CI'] === '1' ||
+  process.env['CONTINUOUS_INTEGRATION'] === 'true' ||
+  process.env['TERM'] === 'dumb' ||
+  !process.stdout.isTTY;
+
+if (!isCI) {
+  process.stdout.write('\n');
+  process.stdout.write('  ┌───────────────────────────────────────────────────────────────┐\n');
+  process.stdout.write('  │  terminalhire installed — activate the Claude Code nudge:     │\n');
+  process.stdout.write('  │                                                               │\n');
+  process.stdout.write('  │    terminalhire init                                          │\n');
+  process.stdout.write('  │                                                               │\n');
+  process.stdout.write('  │  This runs one-command onboarding: optional GitHub sign-in,  │\n');
+  process.stdout.write('  │  seeds your local job cache, then installs the statusLine     │\n');
+  process.stdout.write('  │  hook — with your explicit consent at every step.             │\n');
+  process.stdout.write('  │                                                               │\n');
+  process.stdout.write('  │  No config is changed until you run that command.             │\n');
+  process.stdout.write('  └───────────────────────────────────────────────────────────────┘\n');
+  process.stdout.write('\n');
+}
+
+process.exit(0);