hiregraph 0.1.2 → 0.1.4

package/README.md

@@ -12,7 +12,28 @@ Open Source | Local-First | Bring Your Own Key
 npm install -g hiregraph
 ```
 
-That's it. No account. No sign up. HireGraph reads `ANTHROPIC_API_KEY` from your environment — the same key Claude Code or Cursor already uses.
+### For Claude Code users (recommended)
+
+```bash
+npm install -g hiregraph
+hiregraph install-skill
+```
+
+Then open Claude Code and say: *"Set up hiregraph and scan my projects"*. Claude Code handles everything — no manual commands needed.
+
+### Or install the skill directly
+
+```bash
+npx skills add https://github.com/c0ncepT23/hiregraph --skill hiregraph --yes --global
+```
+
+### API Key
+
+HireGraph reads `ANTHROPIC_API_KEY` from your environment. Set it once:
+
+- **Mac/Linux:** `export ANTHROPIC_API_KEY="sk-ant-..."` (add to `~/.bashrc` or `~/.zshrc`)
+- **Windows:** Add `ANTHROPIC_API_KEY` to System Environment Variables
+- **Claude Code:** Already set automatically
 
 ## Quick Start
 

package/dist/index.js

@@ -3294,9 +3294,202 @@ function getTimeAgo2(isoDate) {
   return `${days}d ago`;
 }
 
+// src/commands/install-skill.ts
+import { homedir as homedir2 } from "os";
+import { join as join11 } from "path";
+import { mkdir as mkdir2, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync10 } from "fs";
+import { dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var SKILL_DIR = join11(homedir2(), ".claude", "skills", "hiregraph");
+var SKILL_CONTENT = `---
+name: hiregraph
+description: "Use when the user wants to scan projects for skills, find jobs, match against job listings, generate resumes, apply to jobs, or track applications. Triggered by: job search, resume, skill graph, apply to jobs, find matches, hiregraph, scan project skills."
+---
+
+# HireGraph \u2014 CLI Job Application Tool
+
+HireGraph is a globally installed CLI tool. You MUST use the \`hiregraph\` CLI commands to interact with it.
+
+## CRITICAL RULES
+
+1. **ONLY use \`hiregraph\` CLI commands.** NEVER manually read, write, or edit files in \`~/.hiregraph/\`. The CLI manages all data.
+2. **NEVER use interactive mode.** Always pass \`--name\`, \`--email\`, \`--role\` flags to \`hiregraph init\`. Interactive prompts (inquirer) do not work in the Bash tool.
+3. **Ask the user** for their name, email, and role BEFORE running \`hiregraph init\`. Do not guess or make up values.
+4. **Check installation first.** If \`hiregraph\` is not found, run \`npm install -g hiregraph\`.
+
+## Commands
+
+### 1. Initialize profile (MUST use flags)
+\`\`\`bash
+hiregraph init --name "Full Name" --email "user@email.com" --role builder --targets "Founding Engineer, Full-Stack" --remote Remote
+\`\`\`
+
+With resume:
+\`\`\`bash
+hiregraph init --name "Full Name" --email "user@email.com" --role engineer --resume /path/to/resume.pdf
+\`\`\`
+
+Valid roles: \`engineer\`, \`pm\`, \`designer\`, \`founder\`, \`builder\`
+
+### 2. Scan projects
+\`\`\`bash
+hiregraph scan /absolute/path/to/project
+hiregraph scan .
+\`\`\`
+
+### 3. View skill graph
+\`\`\`bash
+hiregraph status
+\`\`\`
+
+### 4. Fetch jobs
+\`\`\`bash
+hiregraph jobs
+hiregraph jobs --refresh
+hiregraph jobs --limit 10
+\`\`\`
+
+### 5. Match against jobs
+\`\`\`bash
+hiregraph matches
+hiregraph matches --verbose
+\`\`\`
+
+### 6. Apply to jobs
+\`\`\`bash
+hiregraph apply <job-id> --dry-run    # safe: generates PDF only
+hiregraph apply <job-id>              # submits to ATS
+hiregraph apply --all-above 8         # batch apply
+\`\`\`
+
+### 7. Track applications
+\`\`\`bash
+hiregraph history
+hiregraph history update <app-id> --status interview
+\`\`\`
+
+## Workflow
+
+When the user wants to use hiregraph, follow this exact sequence:
+
+1. Check if installed: \`which hiregraph || npm list -g hiregraph\`
+2. If not installed: \`npm install -g hiregraph\`
+3. Ask user for: name, email, role (engineer/pm/designer/founder/builder)
+4. Run: \`hiregraph init --name "..." --email "..." --role ...\`
+5. Ask which projects to scan, then run: \`hiregraph scan <path>\` for each
+6. Show results: \`hiregraph status\`
+7. If user wants jobs: \`hiregraph jobs\` then \`hiregraph matches\`
+8. If user wants to apply: \`hiregraph apply <job-id> --dry-run\` first, then without --dry-run
+
+## Remember
+
+- NEVER write to ~/.hiregraph/ directly. Always use CLI commands.
+- NEVER run \`hiregraph init\` without --name and --email flags.
+- NEVER skip asking the user for their details before init.
+- All hiregraph commands are non-interactive and safe to run via the Bash tool.
+- Cost: ~$0.003 per scan, ~$0.15 per match run, ~$1.50 first-time job parsing.
+`;
+async function installSkillCommand() {
+  header("\n  HireGraph \u2014 Install Claude Code Skill\n");
+  if (!existsSync10(join11(homedir2(), ".claude"))) {
+    warn("  Claude Code not detected (~/.claude/ not found).");
+    info("  Install Claude Code first: https://claude.ai/code");
+    return;
+  }
+  await mkdir2(SKILL_DIR, { recursive: true });
+  await writeFile3(join11(SKILL_DIR, "SKILL.md"), SKILL_CONTENT, "utf-8");
+  success("  Skill installed to ~/.claude/skills/hiregraph/SKILL.md");
+  console.log();
+  info("  Now open Claude Code and say:");
+  info('  "Set up hiregraph and scan my projects for job matching"');
+  console.log();
+}
+
+// src/commands/setup.ts
+import inquirer3 from "inquirer";
+import { homedir as homedir3 } from "os";
+import { join as join12 } from "path";
+import { readFile as readFile10, writeFile as writeFile4, appendFile } from "fs/promises";
+import { existsSync as existsSync11 } from "fs";
+async function setupCommand(options) {
+  header("\n  HireGraph Setup\n");
+  if (isApiKeyConfigured()) {
+    success("  ANTHROPIC_API_KEY is already set. You're good to go!");
+    info("  Run `hiregraph init` to set up your profile.");
+    return;
+  }
+  console.log("  HireGraph needs an Anthropic API key to power LLM features");
+  console.log("  (job matching, resume tailoring, project classification).\n");
+  console.log("  This is separate from your Claude Code subscription.");
+  console.log("  Get a key at: https://console.anthropic.com/settings/keys\n");
+  console.log("  Anthropic offers free credits for new accounts.");
+  console.log("  HireGraph costs ~$2 for first setup, ~$0.15/day after.\n");
+  let apiKey = options.key;
+  if (!apiKey) {
+    const answer = await inquirer3.prompt([{
+      type: "password",
+      name: "key",
+      message: "Paste your ANTHROPIC_API_KEY:",
+      mask: "*"
+    }]);
+    apiKey = answer.key;
+  }
+  if (!apiKey || !apiKey.startsWith("sk-ant-")) {
+    error('  Invalid key. It should start with "sk-ant-"');
+    return;
+  }
+  process.env.ANTHROPIC_API_KEY = apiKey;
+  const platform = process.platform;
+  if (platform === "win32") {
+    const { execSync } = await import("child_process");
+    try {
+      execSync(`setx ANTHROPIC_API_KEY "${apiKey}"`, { stdio: "pipe" });
+      success("  API key saved to Windows environment variables.");
+      warn("  Restart your terminal for it to take effect everywhere.");
+    } catch {
+      warn("  Could not save to system env. Set it manually:");
+      console.log(`  $env:ANTHROPIC_API_KEY = "${apiKey}"`);
+    }
+  } else {
+    const shell = process.env.SHELL || "/bin/bash";
+    const rcFile = shell.includes("zsh") ? join12(homedir3(), ".zshrc") : join12(homedir3(), ".bashrc");
+    const exportLine = `
+export ANTHROPIC_API_KEY="${apiKey}"
+`;
+    try {
+      if (existsSync11(rcFile)) {
+        const content = await readFile10(rcFile, "utf-8");
+        if (content.includes("ANTHROPIC_API_KEY")) {
+          info(`  Key already in ${rcFile}. Updating...`);
+          const updated = content.replace(
+            /export ANTHROPIC_API_KEY="[^"]*"/,
+            `export ANTHROPIC_API_KEY="${apiKey}"`
+          );
+          await writeFile4(rcFile, updated, "utf-8");
+        } else {
+          await appendFile(rcFile, exportLine);
+        }
+      } else {
+        await writeFile4(rcFile, exportLine);
+      }
+      success(`  API key saved to ${rcFile}`);
+      warn("  Run `source " + rcFile + "` or restart your terminal.");
+    } catch {
+      warn("  Could not save to shell profile. Set it manually:");
+      console.log(`  export ANTHROPIC_API_KEY="${apiKey}"`);
+    }
+  }
+  console.log();
+  success("  Setup complete! Now run:");
+  info('  hiregraph init --name "Your Name" --email "you@email.com" --role builder');
+  console.log();
+}
+
 // src/index.ts
 var program = new Command();
-program.name("hiregraph").description("Turn your code into job applications. Local-first CLI that scans codebases and builds skill graphs.").version("0.1.2");
+program.name("hiregraph").description("Turn your code into job applications. Local-first CLI that scans codebases and builds skill graphs.").version("0.1.4");
 program.command("init").description("Set up your builder profile (resume upload + preferences)").option("--name <name>", "Your full name").option("--email <email>", "Your email address").option("--role <role>", "Your role (engineer, pm, designer, founder, builder)").option("--targets <roles>", "Target roles, comma separated").option("--remote <pref>", "Remote preference (Remote, Hybrid, Onsite)").option("--resume <path>", "Path to resume PDF/TXT").option("--compensation <amount>", "Minimum compensation").action(initCommand);
 program.command("scan").description("Scan a project and update your skill graph").argument("[path]", "Path to the project directory", ".").action(scanCommand);
 program.command("status").description("Show your current skill graph summary").action(statusCommand);
@@ -3304,5 +3497,7 @@ program.command("jobs").description("Fetch job listings from Greenhouse, Lever,
 program.command("matches").description("Match your skill graph against fetched jobs").option("--refresh", "Re-fetch jobs before matching").option("--top <n>", "Number of candidates for LLM evaluation (default 50)", parseInt).option("--verbose", "Show detailed reasoning for all matches").action(matchesCommand);
 program.command("apply").description("Generate a tailored resume and submit to ATS").argument("[job-id]", "Job ID to apply to").option("--all-above <score>", "Apply to all matches above this score", parseFloat).option("--review", "Review each resume before submitting").option("--dry-run", "Generate resume PDF without submitting").action(applyCommand);
 program.command("history").description("View and manage your application history").argument("[action]", 'Action: "update"').argument("[id]", "Application ID").option("--status <status>", "New status (applied, screening, interview, offer, rejected, withdrawn, no-response)").option("--notes <notes>", "Optional notes").action(historyCommand);
+program.command("setup").description("Set up your Anthropic API key (required for LLM features)").option("--key <key>", "Anthropic API key (starts with sk-ant-)").action(setupCommand);
+program.command("install-skill").description("Install the HireGraph skill for Claude Code").action(installSkillCommand);
 program.parse();
 //# sourceMappingURL=index.js.map