grepper-dev 0.2.0

package/README.md

@@ -0,0 +1,108 @@
+# @grepper/cli
+
+Local code review powered by AI. Review your code changes before pushing, right from your terminal.
+
+## Installation
+
+```bash
+npm install -g @grepper/cli
+```
+
+Or use directly with npx:
+
+```bash
+npx @grepper/cli review
+```
+
+## Setup
+
+1. Get your API key from the [Grepper dashboard](https://grepper.dev/dashboard/settings)
+2. Login with your key:
+
+```bash
+grepper login
+```
+
+## Usage
+
+### Review staged changes (default)
+
+```bash
+grepper review
+```
+
+### Review all uncommitted changes
+
+```bash
+grepper review --all
+```
+
+### Review changes against a branch
+
+```bash
+grepper review --base main
+```
+
+### Review specific files
+
+```bash
+grepper review src/api.ts src/utils.ts
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-s, --staged` | Review staged changes only |
+| `-a, --all` | Review all uncommitted changes |
+| `-b, --base <branch>` | Compare against a branch |
+| `-m, --mode <mode>` | Review mode: `full`, `quick`, or `security` |
+| `-f, --format <format>` | Output: `pretty`, `json`, or `markdown` |
+| `--fail-on-critical` | Exit with code 1 if critical issues found |
+
+## Review Modes
+
+- **full** (default) - Comprehensive review covering all aspects
+- **quick** - Fast review focusing on obvious issues
+- **security** - Security-focused review
+
+## Output Formats
+
+- **pretty** (default) - Colored terminal output
+- **json** - Machine-readable JSON for CI/automation
+- **markdown** - Markdown for documentation or PRs
+
+## CI Integration
+
+Use in CI pipelines to catch issues before merge:
+
+```yaml
+- name: Review code
+  run: npx @grepper/cli review --base main --format json --fail-on-critical
+```
+
+## Configuration
+
+Create a `.grepper.json` in your project root:
+
+```json
+{
+  "mode": "full",
+  "ignore": ["*.test.ts", "dist/**"]
+}
+```
+
+The CLI also reads `CLAUDE.md` and `agents.md` for project-specific context.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `grepper login` | Authenticate with your API key |
+| `grepper logout` | Clear stored credentials |
+| `grepper whoami` | Show current user and organization |
+| `grepper review` | Review code changes |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,725 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command, Option } from "commander";
+import updateNotifier from "update-notifier";
+
+// src/commands/login.ts
+import chalk from "chalk";
+
+// src/lib/auth.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_DIR = join(homedir(), ".grepper");
+var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+var DEFAULT_API_URL = "https://grepper.convex.site";
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
+  }
+}
+function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      const data = readFileSync(CONFIG_FILE, "utf-8");
+      return JSON.parse(data);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  ensureConfigDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), {
+    mode: 384
+  });
+}
+function getApiKey() {
+  const envKey = process.env.GREPPER_API_KEY;
+  if (envKey) {
+    return envKey;
+  }
+  const config = loadConfig();
+  return config.apiKey;
+}
+function getApiUrl() {
+  const config = loadConfig();
+  return config.apiUrl ?? process.env.GREPPER_API_URL ?? DEFAULT_API_URL;
+}
+function setApiKey(apiKey) {
+  const config = loadConfig();
+  config.apiKey = apiKey;
+  saveConfig(config);
+}
+function clearCredentials() {
+  const config = loadConfig();
+  config.apiKey = void 0;
+  saveConfig(config);
+}
+function isLoggedIn() {
+  return !!getApiKey();
+}
+
+// src/lib/api.ts
+var REVIEW_TIMEOUT_MS = 12e4;
+var DEFAULT_TIMEOUT_MS = 15e3;
+var ApiError = class extends Error {
+  statusCode;
+  constructor(message, statusCode) {
+    super(message);
+    this.name = "ApiError";
+    this.statusCode = statusCode;
+  }
+};
+function getHeaders() {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    throw new ApiError("Not logged in. Run `grepper login` first.", 401);
+  }
+  return {
+    Authorization: `Bearer ${apiKey}`,
+    "Content-Type": "application/json"
+  };
+}
+async function whoami() {
+  const apiUrl = getApiUrl();
+  const response = await fetch(`${apiUrl}/cli/whoami`, {
+    method: "GET",
+    headers: getHeaders(),
+    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}));
+    throw new ApiError(
+      error.error ?? `API error: ${response.status}`,
+      response.status
+    );
+  }
+  return response.json();
+}
+async function runReview(options) {
+  const apiUrl = getApiUrl();
+  const response = await fetch(`${apiUrl}/cli/review`, {
+    method: "POST",
+    headers: getHeaders(),
+    body: JSON.stringify(options),
+    signal: AbortSignal.timeout(REVIEW_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}));
+    throw new ApiError(
+      error.error ?? `API error: ${response.status}`,
+      response.status
+    );
+  }
+  return response.json();
+}
+
+// src/commands/login.ts
+function promptApiKey() {
+  return new Promise((resolve) => {
+    const { stdin, stdout } = process;
+    stdout.write("Enter your API key: ");
+    const wasRaw = stdin.isRaw;
+    if (stdin.isTTY) {
+      stdin.setRawMode(true);
+    }
+    stdin.resume();
+    stdin.setEncoding("utf-8");
+    let input = "";
+    const onData = (char) => {
+      if (char === "\n" || char === "\r" || char === "") {
+        stdout.write("\n");
+        stdin.removeListener("data", onData);
+        stdin.pause();
+        if (stdin.isTTY && wasRaw !== void 0) {
+          stdin.setRawMode(wasRaw);
+        }
+        resolve(input.trim());
+        return;
+      }
+      if (char === "\x7F" || char === "\b") {
+        if (input.length > 0) {
+          input = input.slice(0, -1);
+          stdout.write("\b \b");
+        }
+        return;
+      }
+      if (char === "") {
+        stdout.write("\n");
+        process.exit(130);
+      }
+      input += char;
+      stdout.write("*");
+    };
+    stdin.on("data", onData);
+  });
+}
+async function loginCommand() {
+  console.log(chalk.bold("\n\u{1F511} Grepper Login\n"));
+  console.log("Get your API key from the Grepper dashboard:");
+  console.log(chalk.dim("https://grepper.dev/dashboard/settings\n"));
+  const apiKey = await promptApiKey();
+  if (!apiKey) {
+    console.error(chalk.red("No API key provided."));
+    process.exit(1);
+  }
+  if (!apiKey.startsWith("grp_")) {
+    console.error(
+      chalk.red('Invalid API key format. Keys should start with "grp_".')
+    );
+    process.exit(1);
+  }
+  try {
+    setApiKey(apiKey);
+    const info = await whoami();
+    console.log(chalk.green("\n\u2713 Logged in successfully!\n"));
+    console.log(`  User: ${info.user.name} (${info.user.email})`);
+    console.log(`  Org:  ${info.org.name} (${info.org.slug})`);
+    console.log(chalk.dim("\n  Credentials saved to ~/.grepper/config.json"));
+  } catch (error) {
+    setApiKey("");
+    if (error instanceof TypeError || error instanceof Error && error.message.includes("fetch")) {
+      console.error(
+        chalk.red(
+          "\nNetwork error: Could not connect to Grepper. Check your internet connection."
+        )
+      );
+      process.exit(1);
+    }
+    console.error(
+      chalk.red(
+        `
+Failed to validate API key: ${error instanceof Error ? error.message : "Unknown error"}`
+      )
+    );
+    process.exit(1);
+  }
+}
+
+// src/commands/logout.ts
+import chalk2 from "chalk";
+function logoutCommand() {
+  if (!isLoggedIn()) {
+    console.error(chalk2.yellow("You are not logged in."));
+    return;
+  }
+  clearCredentials();
+  console.log(chalk2.green("\u2713 Logged out successfully."));
+  console.log(chalk2.dim("  Credentials removed from ~/.grepper/config.json"));
+}
+
+// src/commands/review.ts
+import chalk4 from "chalk";
+import ora from "ora";
+
+// src/lib/context.ts
+import { execFileSync, execSync } from "child_process";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+var MAX_DIFF_SIZE = 100 * 1024;
+var SSH_REMOTE_REGEX = /^git@[^:]+:([^/]+\/[^/]+?)(?:\.git)?$/;
+var GIT_SUFFIX_REGEX = /\.git$/;
+function parseRepoFullName(remoteUrl) {
+  const sshMatch = remoteUrl.match(SSH_REMOTE_REGEX);
+  if (sshMatch?.[1]) {
+    return sshMatch[1];
+  }
+  try {
+    const url = new URL(remoteUrl);
+    const parts = url.pathname.replace(GIT_SUFFIX_REGEX, "").split("/").filter(Boolean);
+    if (parts.length >= 2) {
+      return `${parts[0]}/${parts[1]}`;
+    }
+  } catch {
+  }
+  return null;
+}
+function getRepoFullName() {
+  try {
+    const remoteUrl = execFileSync("git", ["remote", "get-url", "origin"], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    return parseRepoFullName(remoteUrl);
+  } catch {
+    return null;
+  }
+}
+function getProjectRoot() {
+  try {
+    const root = execSync("git rev-parse --show-toplevel", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    return root;
+  } catch {
+    return null;
+  }
+}
+function hasStagedChanges() {
+  try {
+    execSync("git diff --cached --quiet", {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return false;
+  } catch {
+    return true;
+  }
+}
+function hasUnstagedChanges() {
+  try {
+    execSync("git diff --quiet", {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return false;
+  } catch {
+    return true;
+  }
+}
+function getGitDiff(options = {}) {
+  const args = ["diff"];
+  if (options.base) {
+    args.push(`${options.base}...HEAD`);
+  } else if (options.staged) {
+    args.push("--cached");
+  } else if (options.all) {
+    args.push("HEAD");
+  }
+  if (options.files?.length) {
+    args.push("--");
+    args.push(...options.files);
+  }
+  try {
+    const diff = execFileSync("git", args, {
+      encoding: "utf-8",
+      maxBuffer: 10 * 1024 * 1024,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (diff.length > MAX_DIFF_SIZE) {
+      return {
+        diff: diff.slice(0, MAX_DIFF_SIZE),
+        truncated: true
+      };
+    }
+    return { diff, truncated: false };
+  } catch (error) {
+    if (error instanceof Error && "stdout" in error) {
+      const stdout = error.stdout ?? "";
+      if (stdout.length > MAX_DIFF_SIZE) {
+        return {
+          diff: stdout.slice(0, MAX_DIFF_SIZE),
+          truncated: true
+        };
+      }
+      return { diff: stdout, truncated: false };
+    }
+    return { diff: "", truncated: false };
+  }
+}
+function readClaudeMd(projectRoot) {
+  const claudeDir = join2(projectRoot, ".claude", "CLAUDE.md");
+  if (existsSync2(claudeDir)) {
+    return readFileSync2(claudeDir, "utf-8");
+  }
+  const claudeRoot = join2(projectRoot, "CLAUDE.md");
+  if (existsSync2(claudeRoot)) {
+    return readFileSync2(claudeRoot, "utf-8");
+  }
+  return void 0;
+}
+function readAgentsMd(projectRoot) {
+  const agentsPath = join2(projectRoot, "agents.md");
+  if (existsSync2(agentsPath)) {
+    return readFileSync2(agentsPath, "utf-8");
+  }
+  return void 0;
+}
+function readLocalConfig(projectRoot) {
+  const configPath = join2(projectRoot, ".grepper.json");
+  if (existsSync2(configPath)) {
+    try {
+      const data = readFileSync2(configPath, "utf-8");
+      return JSON.parse(data);
+    } catch {
+    }
+  }
+  return void 0;
+}
+
+// src/lib/output.ts
+import chalk3 from "chalk";
+var SEVERITY_ICONS = {
+  critical: "\u{1F534}",
+  warning: "\u{1F7E1}",
+  suggestion: "\u{1F535}",
+  nitpick: "\u26AA",
+  praise: "\u{1F7E2}"
+};
+var SEVERITY_COLORS = {
+  critical: chalk3.red,
+  warning: chalk3.yellow,
+  suggestion: chalk3.blue,
+  nitpick: chalk3.gray,
+  praise: chalk3.green
+};
+function formatFinding(finding) {
+  const icon = SEVERITY_ICONS[finding.severity];
+  const color = SEVERITY_COLORS[finding.severity];
+  const lines = [];
+  const lineRange = finding.endLine && finding.endLine !== finding.startLine ? `${finding.startLine}-${finding.endLine}` : String(finding.startLine);
+  lines.push(
+    `${icon} ${color.bold(finding.severity.charAt(0).toUpperCase() + finding.severity.slice(1))}: ${finding.title}`
+  );
+  lines.push(chalk3.dim(`   ${finding.file}:${lineRange}`));
+  lines.push(`   ${finding.message}`);
+  if (finding.suggestion) {
+    lines.push("");
+    lines.push(chalk3.dim("   Suggested fix:"));
+    const suggestionLines = finding.suggestion.split("\n");
+    for (const line of suggestionLines) {
+      if (line.startsWith("+")) {
+        lines.push(chalk3.green(`   ${line}`));
+      } else if (line.startsWith("-")) {
+        lines.push(chalk3.red(`   ${line}`));
+      } else {
+        lines.push(chalk3.dim(`   ${line}`));
+      }
+    }
+  }
+  return lines.join("\n");
+}
+function formatPretty(output) {
+  const lines = [];
+  lines.push(
+    `
+${chalk3.bold("\u{1F4CB} Reviewed")} ${output.reviewedFiles.length} file${output.reviewedFiles.length === 1 ? "" : "s"}`
+  );
+  if (output.truncated) {
+    lines.push(chalk3.yellow("\u26A0\uFE0F  Diff was truncated due to size limits"));
+  }
+  lines.push("");
+  const critical = output.findings.filter((f) => f.severity === "critical");
+  const warning = output.findings.filter((f) => f.severity === "warning");
+  const suggestion = output.findings.filter((f) => f.severity === "suggestion");
+  const nitpick = output.findings.filter((f) => f.severity === "nitpick");
+  const praise = output.findings.filter((f) => f.severity === "praise");
+  const allFindings = [
+    ...critical,
+    ...warning,
+    ...suggestion,
+    ...nitpick,
+    ...praise
+  ];
+  if (allFindings.length === 0) {
+    lines.push(chalk3.green("\u2728 No issues found!"));
+  } else {
+    for (const finding of allFindings) {
+      lines.push(formatFinding(finding));
+      lines.push("");
+    }
+  }
+  lines.push("\u2500".repeat(40));
+  const counts = [];
+  if (critical.length > 0) {
+    counts.push(chalk3.red(`${critical.length} critical`));
+  }
+  if (warning.length > 0) {
+    counts.push(chalk3.yellow(`${warning.length} warning`));
+  }
+  if (suggestion.length > 0) {
+    counts.push(chalk3.blue(`${suggestion.length} suggestion`));
+  }
+  if (nitpick.length > 0) {
+    counts.push(chalk3.gray(`${nitpick.length} nitpick`));
+  }
+  if (praise.length > 0) {
+    counts.push(chalk3.green(`${praise.length} praise`));
+  }
+  if (counts.length > 0) {
+    lines.push(`Summary: ${counts.join(", ")}`);
+  }
+  if (output.summary) {
+    lines.push(chalk3.dim(output.summary));
+  }
+  return lines.join("\n");
+}
+function formatJson(output) {
+  return JSON.stringify(output, null, 2);
+}
+function formatFindingMarkdown(finding) {
+  const lines = [];
+  const lineRange = finding.endLine && finding.endLine !== finding.startLine ? `${finding.startLine}-${finding.endLine}` : String(finding.startLine);
+  lines.push(`#### ${finding.title}`);
+  lines.push(`\u{1F4CD} \`${finding.file}:${lineRange}\`
+`);
+  lines.push(`${finding.message}
+`);
+  if (finding.suggestion) {
+    lines.push("**Suggested fix:**");
+    lines.push("```diff");
+    lines.push(finding.suggestion);
+    lines.push("```\n");
+  }
+  return lines;
+}
+function groupBySeverity(findings) {
+  const bySeverity = /* @__PURE__ */ new Map();
+  for (const finding of findings) {
+    const list = bySeverity.get(finding.severity) ?? [];
+    list.push(finding);
+    bySeverity.set(finding.severity, list);
+  }
+  return bySeverity;
+}
+var SEVERITY_ORDER = [
+  "critical",
+  "warning",
+  "suggestion",
+  "nitpick",
+  "praise"
+];
+function formatMarkdown(output) {
+  const lines = [];
+  lines.push("## Code Review Results\n");
+  if (output.truncated) {
+    lines.push(
+      "> \u26A0\uFE0F **Note:** Diff was truncated due to size limits. Some files may not have been reviewed.\n"
+    );
+  }
+  if (output.findings.length === 0) {
+    lines.push("\u2728 No issues found!\n");
+  } else {
+    const bySeverity = groupBySeverity(output.findings);
+    for (const severity of SEVERITY_ORDER) {
+      const findings = bySeverity.get(severity);
+      if (!findings?.length) {
+        continue;
+      }
+      const icon = SEVERITY_ICONS[severity];
+      const title = severity.charAt(0).toUpperCase() + severity.slice(1);
+      lines.push(`### ${icon} ${title} (${findings.length})
+`);
+      for (const finding of findings) {
+        lines.push(...formatFindingMarkdown(finding));
+      }
+    }
+  }
+  lines.push("---\n");
+  lines.push(`**Summary:** ${output.summary}`);
+  lines.push(`
+**Files reviewed:** ${output.reviewedFiles.join(", ")}`);
+  return lines.join("\n");
+}
+function formatOutput(output, format) {
+  switch (format) {
+    case "json":
+      return formatJson(output);
+    case "markdown":
+      return formatMarkdown(output);
+    default:
+      return formatPretty(output);
+  }
+}
+
+// src/commands/review.ts
+function determineDiffOptions(options) {
+  if (options.files?.length) {
+    return { files: options.files };
+  }
+  if (options.base) {
+    return { base: options.base };
+  }
+  if (options.staged) {
+    return { staged: true };
+  }
+  if (options.all) {
+    return { all: true };
+  }
+  if (hasStagedChanges()) {
+    console.error(chalk4.dim("Reviewing staged changes..."));
+    return { staged: true };
+  }
+  if (hasUnstagedChanges()) {
+    console.error(chalk4.dim("Reviewing unstaged changes..."));
+    return {};
+  }
+  return null;
+}
+function handleReviewError(error) {
+  if (error instanceof ApiError) {
+    console.error(chalk4.red(`API Error: ${error.message}`));
+    process.exit(2);
+  }
+  if (error instanceof TypeError || error instanceof Error && error.message.includes("fetch")) {
+    console.error(
+      chalk4.red(
+        "Network error: Could not connect to Grepper. Check your internet connection."
+      )
+    );
+    process.exit(2);
+  }
+  console.error(
+    chalk4.red(
+      `Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`
+    )
+  );
+  process.exit(2);
+}
+function showContextInfo(context) {
+  console.error(chalk4.dim(`Mode: ${context.mode}`));
+  if (context.repoFullName) {
+    console.error(chalk4.dim(`Repository: ${context.repoFullName}`));
+  }
+  if (context.claudeMd) {
+    console.error(chalk4.dim("Found CLAUDE.md"));
+  }
+  if (context.agentsMd) {
+    console.error(chalk4.dim("Found agents.md"));
+  }
+  if (context.truncated) {
+    console.error(
+      chalk4.yellow("Diff truncated to 100KB. Some files may not be reviewed.")
+    );
+  }
+}
+function showRepoStatus(repoFullName, repoConnected, skillCount) {
+  if (repoConnected) {
+    console.error(
+      chalk4.dim(`Repository: ${repoFullName} (${skillCount ?? 0} skills)`)
+    );
+  } else {
+    console.error(
+      chalk4.dim(
+        "Tip: Connect this repo at grepper.dev/dashboard for repo-specific review rules"
+      )
+    );
+  }
+}
+async function reviewCommand(options) {
+  if (!isLoggedIn()) {
+    console.error(chalk4.yellow("Not logged in. Run `grepper login` first."));
+    process.exit(1);
+  }
+  const projectRoot = getProjectRoot();
+  if (!projectRoot) {
+    console.error(chalk4.red("Not in a git repository."));
+    process.exit(1);
+  }
+  const diffOptions = determineDiffOptions(options);
+  if (diffOptions === null) {
+    console.error(chalk4.yellow("No changes to review."));
+    console.error(
+      chalk4.dim(
+        "Stage some changes with `git add` or use `--base main` to compare against a branch."
+      )
+    );
+    process.exit(0);
+  }
+  const { diff, truncated } = getGitDiff(diffOptions);
+  if (!diff.trim()) {
+    console.error(chalk4.yellow("No changes to review."));
+    process.exit(0);
+  }
+  const repoFullName = getRepoFullName();
+  const claudeMd = readClaudeMd(projectRoot);
+  const agentsMd = readAgentsMd(projectRoot);
+  const localConfig = readLocalConfig(projectRoot);
+  const mode = options.mode ?? localConfig?.mode ?? "full";
+  const format = options.format ?? "pretty";
+  if (format === "pretty") {
+    showContextInfo({ mode, repoFullName, claudeMd, agentsMd, truncated });
+  }
+  const spinner = format === "pretty" ? ora("Analyzing diff...").start() : null;
+  try {
+    const output = await runReview({
+      diff,
+      mode,
+      claudeMd,
+      agentsMd,
+      repoFullName: repoFullName ?? void 0
+    });
+    if (truncated) {
+      output.truncated = true;
+    }
+    spinner?.stop();
+    console.log(formatOutput(output, format));
+    if (format === "pretty" && repoFullName) {
+      showRepoStatus(repoFullName, output.repoConnected, output.skillCount);
+    }
+    if (options.failOnCritical) {
+      const hasCritical = output.findings.some(
+        (f) => f.severity === "critical"
+      );
+      if (hasCritical) {
+        process.exit(1);
+      }
+    }
+  } catch (error) {
+    spinner?.stop();
+    handleReviewError(error);
+  }
+}
+
+// src/commands/whoami.ts
+import chalk5 from "chalk";
+async function whoamiCommand() {
+  if (!isLoggedIn()) {
+    console.error(chalk5.yellow("Not logged in. Run `grepper login` first."));
+    process.exit(1);
+  }
+  try {
+    const info = await whoami();
+    console.log(chalk5.bold("\n\u{1F4CB} Current Session\n"));
+    console.log(`  User: ${info.user.name} (${info.user.email})`);
+    console.log(`  Org:  ${info.org.name} (${info.org.slug})`);
+  } catch (error) {
+    if (error instanceof TypeError || error instanceof Error && error.message.includes("fetch")) {
+      console.error(
+        chalk5.red(
+          "Network error: Could not connect to Grepper. Check your internet connection."
+        )
+      );
+      process.exit(1);
+    }
+    console.error(
+      chalk5.red(
+        `Failed to get user info: ${error instanceof Error ? error.message : "Unknown error"}`
+      )
+    );
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+updateNotifier({
+  pkg: { name: "grepper-dev", version: "0.2.0" }
+}).notify();
+var program = new Command();
+program.name("grepper").description("Local code review powered by AI").version("0.2.0");
+program.command("login").description("Log in with your Grepper API key").action(async () => {
+  await loginCommand();
+});
+program.command("logout").description("Log out and clear credentials").action(() => {
+  logoutCommand();
+});
+program.command("whoami").description("Show current user and organization").action(async () => {
+  await whoamiCommand();
+});
+program.command("review", { isDefault: true }).description("Review code changes").option("-s, --staged", "Review staged changes only").option("-a, --all", "Review all uncommitted changes (staged + unstaged)").option("-b, --base <branch>", "Review changes against a branch (e.g., main)").addOption(
+  new Option("-m, --mode <mode>", "Review mode").choices(["full", "quick", "security"]).default("full")
+).addOption(
+  new Option("-f, --format <format>", "Output format").choices(["pretty", "json", "markdown"]).default("pretty")
+).option("--fail-on-critical", "Exit with code 1 if critical issues found").argument("[files...]", "Specific files to review").action(async (files, opts) => {
+  await reviewCommand({
+    staged: opts.staged,
+    all: opts.all,
+    base: opts.base,
+    files: files.length > 0 ? files : void 0,
+    mode: opts.mode,
+    format: opts.format,
+    failOnCritical: opts.failOnCritical
+  });
+});
+program.parse();

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "grepper-dev",
+  "version": "0.2.0",
+  "description": "Grepper CLI - Local code review powered by AI",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "grepper": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avr00/grepper.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://grepper.dev",
+  "bugs": {
+    "url": "https://github.com/avr00/grepper/issues"
+  },
+  "keywords": [
+    "code-review",
+    "ai",
+    "cli",
+    "linter",
+    "static-analysis",
+    "developer-tools"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "ora": "^9.3.0",
+    "update-notifier": "^7.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@types/update-notifier": "^6.0.8",
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "@grepper/config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}