@rankcli/cli 0.0.31 → 0.0.33

package/README.md

@@ -157,7 +157,11 @@ The gates are opt-in: without them, a completed audit exits `0` however many iss
 
 #### AI analysis (`--ai`)
 
-AI analysis runs on your own provider - nothing goes through RankCLI. With no `--ai-provider`, the first key found wins, in this order (OpenRouter first):
+AI analysis runs on your own provider - nothing goes through RankCLI.
+
+**On a Mac with Apple Intelligence, it's the default.** On macOS 26 or later on Apple silicon with Apple Intelligence turned on, `--ai` uses Apple's on-device model: free, private, no key and no network round trip. The first run builds a small Swift helper with the Xcode command-line tools (a few seconds, cached in `~/Library/Caches/rankcli`). The on-device model has a small context window, so it sees the 25 most severe issues. To use another provider, pass `--ai-provider`, or set it once with `RANKCLI_AI_PROVIDER=openrouter` (any provider id below).
+
+Otherwise, with no `--ai-provider`, the first key found wins, in this order (OpenRouter first):
 
 | Provider | Env var | Base URL | Default model |
 |----------|---------|----------|---------------|
@@ -207,7 +211,7 @@ rankcli apply --url https://mysite.com --auto      # Auto-apply
 
 ### `rankcli keywords`
 
-AI-powered keyword research.
+AI-powered keyword research. `--ai` runs on the same provider as `audit --ai` (Apple Intelligence on a Mac that has it, else your key, else a local Ollama) and takes the same `--ai-provider` / `--ai-key` / `--ai-model` / `--ai-base-url` flags. Keyword clustering uses embeddings on OpenAI and term vectors everywhere else; local models judge 5 tool ideas instead of 15.
 
 ```bash
 rankcli keywords --url https://mysite.com --ai

package/dist/index.js

@@ -1453,6 +1453,177 @@ var TOGETHER_DEFAULT = "openai/gpt-oss-120b";
 var FIREWORKS_DEFAULT = "accounts/fireworks/models/gpt-oss-120b";
 var CEREBRAS_DEFAULT = "gpt-oss-120b";
 
+// src/lib/apple-ai.ts
+var import_node_child_process = require("child_process");
+var import_node_crypto2 = require("crypto");
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+
+// src/lib/apple-ai-source.ts
+var APPLE_AI_SWIFT_SOURCE = String.raw`import Foundation
+import FoundationModels
+
+func reply(_ object: [String: Any], code: Int32 = 0) -> Never {
+    let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data("{\"error\":\"could not encode the reply\"}".utf8)
+    FileHandle.standardOutput.write(data)
+    exit(code)
+}
+
+let model = SystemLanguageModel.default
+
+if CommandLine.arguments.contains("--check") {
+    switch model.availability {
+    case .available:
+        reply(["available": true])
+    case .unavailable(let reason):
+        switch reason {
+        case .deviceNotEligible: reply(["available": false, "reason": "deviceNotEligible"])
+        case .appleIntelligenceNotEnabled: reply(["available": false, "reason": "appleIntelligenceNotEnabled"])
+        case .modelNotReady: reply(["available": false, "reason": "modelNotReady"])
+        @unknown default: reply(["available": false, "reason": "unavailable"])
+        }
+    @unknown default:
+        reply(["available": false, "reason": "unavailable"])
+    }
+}
+
+struct Request: Decodable {
+    let system: String?
+    let prompt: String
+    let maxTokens: Int?
+}
+
+let input = FileHandle.standardInput.readDataToEndOfFile()
+guard let request = try? JSONDecoder().decode(Request.self, from: input) else {
+    reply(["error": "expected a JSON request on stdin"], code: 2)
+}
+
+let session: LanguageModelSession
+if let system = request.system {
+    session = LanguageModelSession(instructions: system)
+} else {
+    session = LanguageModelSession()
+}
+
+do {
+    let response = try await session.respond(
+        to: request.prompt,
+        options: GenerationOptions(maximumResponseTokens: request.maxTokens)
+    )
+    reply(["text": response.content])
+} catch let error as LanguageModelSession.GenerationError {
+    switch error {
+    case .exceededContextWindowSize:
+        reply(["error": "the prompt is too long for the on-device model"], code: 1)
+    case .guardrailViolation:
+        reply(["error": "the on-device model's guardrails declined the request"], code: 1)
+    case .assetsUnavailable:
+        reply(["error": "the on-device model isn't downloaded yet"], code: 1)
+    default:
+        reply(["error": String(describing: error)], code: 1)
+    }
+} catch {
+    reply(["error": String(describing: error)], code: 1)
+}
+`;
+
+// src/lib/apple-ai.ts
+function isAppleIntelligenceCapable(platform = process.platform, arch = process.arch, darwinRelease = (0, import_node_os.release)()) {
+  return platform === "darwin" && arch === "arm64" && Number(darwinRelease.split(".")[0]) >= 25;
+}
+var REASONS = {
+  deviceNotEligible: "this Mac doesn't support Apple Intelligence",
+  appleIntelligenceNotEnabled: "Apple Intelligence is turned off (System Settings > Apple Intelligence & Siri)",
+  modelNotReady: "the on-device model is still downloading"
+};
+function run(file, args, opts) {
+  return new Promise((resolve) => {
+    const child = (0, import_node_child_process.spawn)(file, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGKILL");
+    }, opts.timeoutMs);
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.on("data", (d) => stderr += d);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      resolve({ code: null, stdout, stderr: stderr || error.message, timedOut });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve({ code, stdout, stderr, timedOut });
+    });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end(opts.input ?? "");
+  });
+}
+function hasDeveloperTools() {
+  return new Promise((resolve) => (0, import_node_child_process.execFile)("xcode-select", ["-p"], (error) => resolve(!error)));
+}
+var helperPromise = null;
+function ensureHelper(env) {
+  if (env.RANKCLI_APPLE_AI_HELPER) return Promise.resolve({ helper: env.RANKCLI_APPLE_AI_HELPER });
+  helperPromise ??= (async () => {
+    const hash = (0, import_node_crypto2.createHash)("sha256").update(APPLE_AI_SWIFT_SOURCE).digest("hex").slice(0, 12);
+    const dir = (0, import_node_path.join)((0, import_node_os.homedir)(), "Library", "Caches", "rankcli", `apple-ai-${hash}`);
+    const helper = (0, import_node_path.join)(dir, "rankcli-apple-ai");
+    if ((0, import_node_fs.existsSync)(helper)) return { helper };
+    const failed = (0, import_node_path.join)(dir, "build-failed");
+    if ((0, import_node_fs.existsSync)(failed) && Date.now() - (0, import_node_fs.statSync)(failed).mtimeMs < 7 * 24 * 60 * 60 * 1e3) {
+      return { error: (0, import_node_fs.readFileSync)(failed, "utf8") };
+    }
+    if (!await hasDeveloperTools()) {
+      return { error: "using it needs the Xcode command-line tools (xcode-select --install)" };
+    }
+    (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+    const source = (0, import_node_path.join)(dir, "main.swift");
+    (0, import_node_fs.writeFileSync)(source, APPLE_AI_SWIFT_SOURCE);
+    process.stderr.write("Preparing Apple Intelligence for RankCLI (one-time build of a small helper)...\n");
+    const tmp = `${helper}.${process.pid}`;
+    const build = await run("xcrun", ["swiftc", "-O", "-target", "arm64-apple-macos26.0", source, "-o", tmp], { timeoutMs: 18e4 });
+    if (build.code !== 0 || !(0, import_node_fs.existsSync)(tmp)) {
+      const firstError = build.stderr.split("\n").find((line) => /error:/.test(line))?.trim();
+      const error = `the helper didn't build${firstError ? ` (${firstError})` : ""} - it needs the macOS 26 SDK (update Xcode or its command-line tools)`;
+      (0, import_node_fs.writeFileSync)(failed, error);
+      return { error };
+    }
+    (0, import_node_fs.renameSync)(tmp, helper);
+    return { helper };
+  })();
+  return helperPromise;
+}
+async function checkAppleAI(env = process.env) {
+  if (!env.RANKCLI_APPLE_AI_HELPER && !isAppleIntelligenceCapable()) {
+    return { available: false, reason: "it needs macOS 26 or later on Apple silicon" };
+  }
+  const ensured = await ensureHelper(env);
+  if ("error" in ensured) return { available: false, reason: ensured.error };
+  const check = await run(ensured.helper, ["--check"], { timeoutMs: 15e3 });
+  try {
+    const status = JSON.parse(check.stdout);
+    if (status.available) return { available: true, helper: ensured.helper };
+    return { available: false, reason: REASONS[status.reason ?? ""] ?? "Apple Intelligence is unavailable" };
+  } catch {
+    return { available: false, reason: `the helper failed (${(check.stderr || check.stdout).trim().slice(0, 120) || `exit ${check.code}`})` };
+  }
+}
+async function generateWithAppleAI(helper, request, timeoutMs = 12e4) {
+  const result = await run(helper, [], { input: JSON.stringify(request), timeoutMs });
+  if (result.timedOut) return { error: `timed out after ${Math.round(timeoutMs / 1e3)}s` };
+  try {
+    const reply = JSON.parse(result.stdout);
+    if (typeof reply.text === "string") return { text: reply.text };
+    return { error: reply.error || "no reply" };
+  } catch {
+    return { error: (result.stderr || result.stdout).trim().slice(0, 200) || `exit ${result.code}` };
+  }
+}
+
 // src/lib/ai.ts
 var AI_PROVIDERS = {
   // Hosted
@@ -1467,6 +1638,7 @@ var AI_PROVIDERS = {
   together: { label: "Together", baseUrl: "https://api.together.xyz/v1", model: TOGETHER_DEFAULT, envKeys: ["TOGETHER_API_KEY"] },
   fireworks: { label: "Fireworks", baseUrl: "https://api.fireworks.ai/inference/v1", model: FIREWORKS_DEFAULT, envKeys: ["FIREWORKS_API_KEY"] },
   // Local / self-hosted
+  apple: { label: "Apple Intelligence", model: "on-device", envKeys: [], local: true },
   ollama: { label: "Ollama", baseUrl: "http://localhost:11434/v1", envKeys: [], local: true },
   lmstudio: { label: "LM Studio", baseUrl: "http://localhost:1234/v1", envKeys: [], local: true },
   llamacpp: { label: "llama.cpp", baseUrl: "http://localhost:8080/v1", envKeys: [], local: true },
@@ -1531,28 +1703,62 @@ async function firstServerModel(baseUrl, apiKey) {
 }
 function noProviderHints() {
   return [
+    "On a Mac with Apple Intelligence (macOS 26+), the on-device model is used automatically",
     `Set one of ${AI_ENV_KEYS.join(", ")}, or pass --ai-key`,
     "Or run a local model: start Ollama (https://ollama.com) and `ollama pull llama3.2` - it is picked up automatically",
     "Or point at any OpenAI-compatible server: --ai-base-url http://localhost:8080/v1 --ai-model <name>"
   ];
 }
-async function resolveAIProvider(opts, env = process.env, probe = probeOllama) {
-  let provider = opts.aiProvider?.trim().toLowerCase();
+function appleResolution(status, notice) {
+  const preset = AI_PROVIDERS.apple;
+  return {
+    ok: true,
+    ai: {
+      provider: "apple",
+      label: preset.label,
+      baseUrl: "",
+      model: preset.model,
+      jsonMode: false,
+      anthropic: false,
+      local: true,
+      helper: status.helper,
+      notice
+    }
+  };
+}
+async function resolveAIProvider(opts, env = process.env, probe = probeOllama, probeApple = checkAppleAI) {
+  const requested = opts.aiProvider?.trim() || (!opts.aiKey && !opts.aiBaseUrl ? env.RANKCLI_AI_PROVIDER?.trim() : void 0);
+  let provider = requested?.toLowerCase();
   let notice;
   let ollamaModels = null;
   if (provider && !AI_PROVIDERS[provider]) {
     return {
       ok: false,
-      error: `Unknown AI provider "${opts.aiProvider}"`,
+      error: `Unknown AI provider "${requested}"`,
       hints: [`Choose one of: ${AI_PROVIDER_IDS.join(", ")}`]
     };
   }
+  if (provider === "apple") {
+    const apple = await probeApple(env);
+    if (!apple.available) {
+      return {
+        ok: false,
+        error: `Apple Intelligence isn't available: ${apple.reason}`,
+        hints: ["Choose another provider with --ai-provider (e.g. openrouter, ollama)"]
+      };
+    }
+    return appleResolution(apple);
+  }
   if (!provider) {
     if (opts.aiBaseUrl) {
       provider = "custom";
     } else if (opts.aiKey) {
       provider = providerFromKey(opts.aiKey) ?? "openai";
     } else {
+      const apple = await probeApple(env);
+      if (apple.available) {
+        return appleResolution(apple, "Using Apple Intelligence on this Mac (on-device, free) - pass --ai-provider to use another");
+      }
       provider = DETECT_ORDER.find((id) => AI_PROVIDERS[id].envKeys.some((k) => env[k]));
     }
   }
@@ -1692,9 +1898,11 @@ function normalizeAnalysis(raw) {
 }
 var SEVERITY_ORDER = { critical: 0, error: 1, warning: 2, notice: 3, info: 3 };
 var MAX_ISSUES_IN_PROMPT = 60;
-function buildPrompt(url, issues) {
+var APPLE_MAX_ISSUES = 25;
+var APPLE_MAX_TOKENS = 1200;
+function buildPrompt(url, issues, maxIssues = MAX_ISSUES_IN_PROMPT) {
   const ranked = [...issues].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4));
-  const shown = ranked.slice(0, MAX_ISSUES_IN_PROMPT);
+  const shown = ranked.slice(0, maxIssues);
   const more = ranked.length > shown.length ? `
 (${ranked.length - shown.length} lower-severity issues omitted)` : "";
   return `Analyze these SEO audit results and provide prioritized recommendations:
@@ -1714,10 +1922,27 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const prompt = buildPrompt(url, issues);
-  const system = "You are an SEO expert. Respond with valid JSON only.";
+  const reply = await completeWithAI(ai, {
+    system: "You are an SEO expert. Respond with valid JSON only.",
+    prompt: buildPrompt(url, issues, ai.provider === "apple" ? APPLE_MAX_ISSUES : MAX_ISSUES_IN_PROMPT),
+    json: true
+  });
+  if ("error" in reply) return reply;
+  return parseAnalysis(reply.text, ai);
+}
+async function completeWithAI(ai, request) {
+  const { system, prompt } = request;
+  if (ai.provider === "apple" && ai.helper) {
+    const reply = await generateWithAppleAI(ai.helper, {
+      system,
+      prompt,
+      maxTokens: Math.min(request.maxTokens ?? APPLE_MAX_TOKENS, APPLE_MAX_TOKENS)
+    });
+    if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
+    return reply;
+  }
   const timeoutMs = ai.local ? 3e5 : 9e4;
-  const maxTokens = 4096;
+  const maxTokens = Math.max(request.maxTokens ?? 4096, 4096);
   const headers = { "Content-Type": "application/json" };
   let endpoint;
   let body;
@@ -1725,7 +1950,7 @@ async function runAIAnalysis(url, issues, ai) {
     endpoint = `${ai.baseUrl}/messages`;
     headers["x-api-key"] = ai.apiKey || "";
     headers["anthropic-version"] = "2023-06-01";
-    body = { model: ai.model, max_tokens: maxTokens, system, messages: [{ role: "user", content: prompt }] };
+    body = { model: ai.model, max_tokens: maxTokens, ...system ? { system } : {}, messages: [{ role: "user", content: prompt }] };
   } else {
     endpoint = `${ai.baseUrl}/chat/completions`;
     if (ai.apiKey) headers["Authorization"] = `Bearer ${ai.apiKey}`;
@@ -1736,12 +1961,12 @@ async function runAIAnalysis(url, issues, ai) {
     body = {
       model: ai.model,
       messages: [
-        { role: "system", content: system },
+        ...system ? [{ role: "system", content: system }] : [],
         { role: "user", content: prompt }
       ],
       // OpenAI's GPT-5.6 rejects max_tokens (and temperature); everyone else expects max_tokens.
       ...ai.provider === "openai" && !ai.local ? { max_completion_tokens: maxTokens } : { max_tokens: maxTokens },
-      ...ai.jsonMode ? { response_format: { type: "json_object" } } : {}
+      ...ai.jsonMode && request.json ? { response_format: { type: "json_object" } } : {}
     };
   }
   let response;
@@ -1765,6 +1990,9 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
+  return { text: content };
+}
+function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
   const analysis = parsed ? normalizeAnalysis(parsed) : null;
   if (!analysis) {
@@ -3018,7 +3246,7 @@ async function trackHistory(options) {
     }
     const days = options.days || 30;
     const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
-    const { data: historyData, error } = await supabase.from("rankings").select("position, url, recorded_at").eq("keyword_id", keywordData.id).gte("recorded_at", cutoff.toISOString()).order("recorded_at", { ascending: false });
+    const { data: historyData, error } = await supabase.from("keyword_position_history").select("position, url, checked_at").eq("keyword_id", keywordData.id).gte("checked_at", cutoff.toISOString()).order("checked_at", { ascending: false });
     if (error) {
       spinner.fail(`Failed to load history: ${error.message}`);
       return { success: false, error: error.message };
@@ -3027,7 +3255,7 @@ async function trackHistory(options) {
     const history = (historyData || []).map((row) => ({
       position: row.position,
       url: row.url,
-      recordedAt: new Date(row.recorded_at)
+      recordedAt: new Date(row.checked_at)
     }));
     if (options.output === "json") {
       console.log(JSON.stringify({ keyword: options.keyword, history }, null, 2));
@@ -3035,7 +3263,9 @@ async function trackHistory(options) {
       console.log("\n" + import_chalk6.default.bold(`\u{1F4C8} History: "${options.keyword}"`));
       console.log("\u2550".repeat(50));
       if (history.length === 0) {
-        console.log(import_chalk6.default.dim("\nNo history available yet.\n"));
+        console.log(import_chalk6.default.dim(`
+No checks recorded yet. Run 'rankcli track check --url <your site>' to record one.
+`));
       } else {
         const positions = history.slice(0, 30).reverse().map((h) => h.position || 101);
         const sparkline = positions.map((p) => {
@@ -3046,7 +3276,7 @@ async function trackHistory(options) {
         }).join("");
         console.log(`
   ${sparkline}  (last ${positions.length} checks)`);
-        console.log(import_chalk6.default.dim("  \u2190 newer                    older \u2192\n"));
+        console.log(import_chalk6.default.dim("  \u2190 older                    newer \u2192\n"));
         const recent = history.slice(0, 10);
         for (const entry of recent) {
           console.log(`  ${entry.recordedAt.toLocaleDateString()}  ${formatPosition(entry.position)}`);
@@ -3360,6 +3590,40 @@ async function geo(options) {
 // src/commands/keywords.ts
 var readline2 = __toESM(require("readline"));
 var import_agent_runtime7 = require("@rankcli/agent-runtime");
+
+// src/lib/keyword-llm.ts
+async function openAIEmbeddings(ai, texts) {
+  const response = await fetch(`${ai.baseUrl}/embeddings`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${ai.apiKey}` },
+    body: JSON.stringify({ model: "text-embedding-3-small", input: texts }),
+    signal: AbortSignal.timeout(6e4)
+  });
+  if (!response.ok) throw new Error(`OpenAI embeddings returned HTTP ${response.status}`);
+  const data = await response.json();
+  return data.data.map((item) => item.embedding);
+}
+function keywordLLMFromAI(ai) {
+  const llm = {
+    async complete(prompt, opts = {}) {
+      const reply = await completeWithAI(ai, { system: opts.system, prompt, maxTokens: opts.maxTokens, json: true });
+      if ("error" in reply) throw new Error(reply.error);
+      return reply.text;
+    }
+  };
+  if (ai.provider === "openai" && ai.apiKey && ai.jsonMode) {
+    llm.embed = (texts) => openAIEmbeddings(ai, texts);
+  }
+  if (ai.provider === "apple") {
+    llm.maxContentChars = 5e3;
+    llm.maxToolIdeas = 5;
+  } else if (ai.local) {
+    llm.maxToolIdeas = 5;
+  }
+  return llm;
+}
+
+// src/commands/keywords.ts
 async function keywords(options) {
   console.log("\n\u{1F511} RankCLI - Keyword Research\n");
   console.log("This tool helps you find keywords you can actually rank for,");
@@ -3520,65 +3784,37 @@ async function keywordsQuick(url, providedSeeds) {
 `);
   }
 }
-var SUPABASE_URL = "https://eqzlmjbvrtrglknphdai.supabase.co";
 async function keywordsAI(url, options = {}) {
   console.log("\n\u{1F916} AI-Powered Keyword Research\n");
-  console.log("This uses GPT-4 to analyze your site and generate keyword recommendations");
-  console.log("with competitive analysis and free tool ideas.\n");
-  const openaiApiKey = options.openaiApiKey || process.env.OPENAI_API_KEY;
   try {
     const parsed = new URL(url.startsWith("http") ? url : `https://${url}`);
     url = parsed.href;
-    console.log(`\u{1F4CD} Analyzing: ${url}`);
-    console.log("");
-    if (!options.forceLocal) {
-      console.log("\u{1F517} Connecting to RankCLI cloud...");
-      try {
-        const response = await fetch(`${SUPABASE_URL}/functions/v1/ai-keywords`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-            // Auth header would go here if user is logged in
-          },
-          body: JSON.stringify({
-            url,
-            mode: "analyze"
-          })
-        });
-        if (response.ok) {
-          const result2 = await response.json();
-          if (result2.tier === "free" && result2.teaser) {
-            console.log("\n" + "\u2500".repeat(60));
-            console.log("\u{1F512} FREE TIER - Limited Preview");
-            console.log("\u2500".repeat(60));
-            console.log(`Found ${result2.teaser.totalKeywordsFound} keywords`);
-            console.log(`Top keywords: ${result2.teaser.topKeywords.join(", ")}`);
-            console.log(`
-${result2.teaser.upgradeMessage}`);
-            console.log('\n\u{1F4A1} Run "rankcli login" to access your paid plan features.\n');
-            return;
-          }
-          displayAIKeywordResults(result2);
-          return;
-        } else {
-          const errorText = await response.text();
-          console.log(`\u26A0\uFE0F  Cloud request failed, running locally...
-`);
-        }
-      } catch (err) {
-        console.log("\u26A0\uFE0F  Cloud unavailable, running locally...\n");
-      }
+    const resolution = await resolveAIProvider(options);
+    if (!resolution.ok) {
+      console.log(`\u274C ${resolution.error}`);
+      for (const hint of resolution.hints) console.log(`   ${hint}`);
+      console.log("");
+      process.exitCode = 1;
+      return;
     }
-    if (!openaiApiKey) {
-      console.log("\u274C OpenAI API key required for local processing.");
-      console.log('   Set OPENAI_API_KEY environment variable, or use "rankcli login" for cloud processing.\n');
+    const { ai } = resolution;
+    if (ai.notice) console.log(ai.notice);
+    const check = await completeWithAI(ai, { prompt: 'Reply with the JSON object {"ok": true} and nothing else.', maxTokens: 50, json: true });
+    if ("error" in check) {
+      console.log(`\u274C ${check.error}`);
+      console.log("   Choose another provider with --ai-provider, or fix the key or model and try again.\n");
+      process.exitCode = 1;
       return;
     }
-    console.log("\u{1F52C} Running local AI analysis (this may take a minute)...\n");
+    console.log(`\u{1F4CD} Analyzing: ${url}`);
+    console.log(`\u{1F9E0} Model: ${ai.label} (${ai.model})
+`);
+    console.log(`\u{1F52C} Running AI analysis (${ai.local ? "a few minutes on a local model" : "this may take a minute"})...
+`);
     const result = await (0, import_agent_runtime7.runAIKeywordResearch)({
       url,
       tier: "solo",
-      openaiApiKey,
+      llm: keywordLLMFromAI(ai),
       enableEnhancedToolIdeas: true,
       competitiveSearchKeys: {
         braveApiKey: process.env.BRAVE_API_KEY,
@@ -3591,6 +3827,7 @@ ${result2.teaser.upgradeMessage}`);
     console.log(`
 \u274C Error: ${error instanceof Error ? error.message : "Unknown error"}
 `);
+    process.exitCode = 1;
   }
 }
 function displayAIKeywordResults(result) {
@@ -4002,7 +4239,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.31";
+var VERSION = "0.0.33";
 
 // src/index.ts
 var program = new import_commander.Command();
@@ -4014,7 +4251,7 @@ program.command("logout").description("Log out of your RankCLI account").action(
 program.command("whoami").description("Show current logged in user").action(whoami);
 program.command("init").description("Set up RankCLI in your project (detects framework, git/GitHub, AI keys)").option("-y, --yes", "Skip prompts and use defaults").action(init);
 program.command("analyze").description("AI analyzes your codebase for SEO opportunities").option("-v, --verbose", "Show detailed output").action(analyze);
-program.command("audit").description("Run a comprehensive SEO audit (200+ checks, Ahrefs-level)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted): openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
+program.command("audit").description("Run an SEO + GEO audit (280+ checks)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted; Apple Intelligence on a Mac that has it, or set RANKCLI_AI_PROVIDER): apple, openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
   process.exitCode = await audit(options);
 });
 program.command("apply").description("Analyze a live URL and apply SEO fixes to your codebase").option("-u, --url <url>", "URL to analyze").option("--auto", "Auto-apply fixes without confirmation").option("--dry-run", "Preview changes without applying").action(apply);
@@ -4033,11 +4270,13 @@ program.command("fix").description("Agentic SEO fixer - detect, fix, commit, and
   }
 });
 program.command("geo").description("GEO analysis - Check AI search visibility (ChatGPT, Perplexity, Claude)").option("-u, --url <url>", "URL to analyze").option("-o, --output <format>", "Output format (json, console)", "console").action(geo);
-program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "Use GPT-4 for enhanced analysis with free tool ideas").option("--local", "Force local processing (skip cloud worker)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
+program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "AI keyword research with free tool ideas, on your own provider (Apple Intelligence on a Mac that has it)").option("--ai-provider <provider>", "AI provider for --ai (auto-detected if omitted, or set RANKCLI_AI_PROVIDER)").option("--ai-key <key>", "AI provider API key (or the provider's env var)").option("--ai-model <model>", "Override the provider's default model").option("--ai-base-url <url>", "Any OpenAI-compatible server (implies --ai-provider custom)").option("--local", "No effect; --ai always runs locally on your provider (kept for old scripts)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
   if (options.ai && options.url) {
     await keywordsAI(options.url, {
-      forceLocal: options.local,
-      openaiApiKey: process.env.OPENAI_API_KEY
+      aiProvider: options.aiProvider,
+      aiKey: options.aiKey,
+      aiModel: options.aiModel,
+      aiBaseUrl: options.aiBaseUrl
     });
   } else if (options.competitor && options.url && options.seed) {
     const seeds = options.seed.split(",").map((s) => s.trim());

package/dist/index.mjs

@@ -1274,6 +1274,177 @@ var TOGETHER_DEFAULT = "openai/gpt-oss-120b";
 var FIREWORKS_DEFAULT = "accounts/fireworks/models/gpt-oss-120b";
 var CEREBRAS_DEFAULT = "gpt-oss-120b";
 
+// src/lib/apple-ai.ts
+import { execFile, spawn } from "child_process";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync4, renameSync, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { homedir, release } from "os";
+import { join as join4 } from "path";
+
+// src/lib/apple-ai-source.ts
+var APPLE_AI_SWIFT_SOURCE = String.raw`import Foundation
+import FoundationModels
+
+func reply(_ object: [String: Any], code: Int32 = 0) -> Never {
+    let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data("{\"error\":\"could not encode the reply\"}".utf8)
+    FileHandle.standardOutput.write(data)
+    exit(code)
+}
+
+let model = SystemLanguageModel.default
+
+if CommandLine.arguments.contains("--check") {
+    switch model.availability {
+    case .available:
+        reply(["available": true])
+    case .unavailable(let reason):
+        switch reason {
+        case .deviceNotEligible: reply(["available": false, "reason": "deviceNotEligible"])
+        case .appleIntelligenceNotEnabled: reply(["available": false, "reason": "appleIntelligenceNotEnabled"])
+        case .modelNotReady: reply(["available": false, "reason": "modelNotReady"])
+        @unknown default: reply(["available": false, "reason": "unavailable"])
+        }
+    @unknown default:
+        reply(["available": false, "reason": "unavailable"])
+    }
+}
+
+struct Request: Decodable {
+    let system: String?
+    let prompt: String
+    let maxTokens: Int?
+}
+
+let input = FileHandle.standardInput.readDataToEndOfFile()
+guard let request = try? JSONDecoder().decode(Request.self, from: input) else {
+    reply(["error": "expected a JSON request on stdin"], code: 2)
+}
+
+let session: LanguageModelSession
+if let system = request.system {
+    session = LanguageModelSession(instructions: system)
+} else {
+    session = LanguageModelSession()
+}
+
+do {
+    let response = try await session.respond(
+        to: request.prompt,
+        options: GenerationOptions(maximumResponseTokens: request.maxTokens)
+    )
+    reply(["text": response.content])
+} catch let error as LanguageModelSession.GenerationError {
+    switch error {
+    case .exceededContextWindowSize:
+        reply(["error": "the prompt is too long for the on-device model"], code: 1)
+    case .guardrailViolation:
+        reply(["error": "the on-device model's guardrails declined the request"], code: 1)
+    case .assetsUnavailable:
+        reply(["error": "the on-device model isn't downloaded yet"], code: 1)
+    default:
+        reply(["error": String(describing: error)], code: 1)
+    }
+} catch {
+    reply(["error": String(describing: error)], code: 1)
+}
+`;
+
+// src/lib/apple-ai.ts
+function isAppleIntelligenceCapable(platform = process.platform, arch = process.arch, darwinRelease = release()) {
+  return platform === "darwin" && arch === "arm64" && Number(darwinRelease.split(".")[0]) >= 25;
+}
+var REASONS = {
+  deviceNotEligible: "this Mac doesn't support Apple Intelligence",
+  appleIntelligenceNotEnabled: "Apple Intelligence is turned off (System Settings > Apple Intelligence & Siri)",
+  modelNotReady: "the on-device model is still downloading"
+};
+function run(file, args, opts) {
+  return new Promise((resolve) => {
+    const child = spawn(file, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGKILL");
+    }, opts.timeoutMs);
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.on("data", (d) => stderr += d);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      resolve({ code: null, stdout, stderr: stderr || error.message, timedOut });
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve({ code, stdout, stderr, timedOut });
+    });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end(opts.input ?? "");
+  });
+}
+function hasDeveloperTools() {
+  return new Promise((resolve) => execFile("xcode-select", ["-p"], (error) => resolve(!error)));
+}
+var helperPromise = null;
+function ensureHelper(env) {
+  if (env.RANKCLI_APPLE_AI_HELPER) return Promise.resolve({ helper: env.RANKCLI_APPLE_AI_HELPER });
+  helperPromise ??= (async () => {
+    const hash = createHash2("sha256").update(APPLE_AI_SWIFT_SOURCE).digest("hex").slice(0, 12);
+    const dir = join4(homedir(), "Library", "Caches", "rankcli", `apple-ai-${hash}`);
+    const helper = join4(dir, "rankcli-apple-ai");
+    if (existsSync4(helper)) return { helper };
+    const failed = join4(dir, "build-failed");
+    if (existsSync4(failed) && Date.now() - statSync2(failed).mtimeMs < 7 * 24 * 60 * 60 * 1e3) {
+      return { error: readFileSync4(failed, "utf8") };
+    }
+    if (!await hasDeveloperTools()) {
+      return { error: "using it needs the Xcode command-line tools (xcode-select --install)" };
+    }
+    mkdirSync(dir, { recursive: true });
+    const source = join4(dir, "main.swift");
+    writeFileSync3(source, APPLE_AI_SWIFT_SOURCE);
+    process.stderr.write("Preparing Apple Intelligence for RankCLI (one-time build of a small helper)...\n");
+    const tmp = `${helper}.${process.pid}`;
+    const build = await run("xcrun", ["swiftc", "-O", "-target", "arm64-apple-macos26.0", source, "-o", tmp], { timeoutMs: 18e4 });
+    if (build.code !== 0 || !existsSync4(tmp)) {
+      const firstError = build.stderr.split("\n").find((line) => /error:/.test(line))?.trim();
+      const error = `the helper didn't build${firstError ? ` (${firstError})` : ""} - it needs the macOS 26 SDK (update Xcode or its command-line tools)`;
+      writeFileSync3(failed, error);
+      return { error };
+    }
+    renameSync(tmp, helper);
+    return { helper };
+  })();
+  return helperPromise;
+}
+async function checkAppleAI(env = process.env) {
+  if (!env.RANKCLI_APPLE_AI_HELPER && !isAppleIntelligenceCapable()) {
+    return { available: false, reason: "it needs macOS 26 or later on Apple silicon" };
+  }
+  const ensured = await ensureHelper(env);
+  if ("error" in ensured) return { available: false, reason: ensured.error };
+  const check = await run(ensured.helper, ["--check"], { timeoutMs: 15e3 });
+  try {
+    const status = JSON.parse(check.stdout);
+    if (status.available) return { available: true, helper: ensured.helper };
+    return { available: false, reason: REASONS[status.reason ?? ""] ?? "Apple Intelligence is unavailable" };
+  } catch {
+    return { available: false, reason: `the helper failed (${(check.stderr || check.stdout).trim().slice(0, 120) || `exit ${check.code}`})` };
+  }
+}
+async function generateWithAppleAI(helper, request, timeoutMs = 12e4) {
+  const result = await run(helper, [], { input: JSON.stringify(request), timeoutMs });
+  if (result.timedOut) return { error: `timed out after ${Math.round(timeoutMs / 1e3)}s` };
+  try {
+    const reply = JSON.parse(result.stdout);
+    if (typeof reply.text === "string") return { text: reply.text };
+    return { error: reply.error || "no reply" };
+  } catch {
+    return { error: (result.stderr || result.stdout).trim().slice(0, 200) || `exit ${result.code}` };
+  }
+}
+
 // src/lib/ai.ts
 var AI_PROVIDERS = {
   // Hosted
@@ -1288,6 +1459,7 @@ var AI_PROVIDERS = {
   together: { label: "Together", baseUrl: "https://api.together.xyz/v1", model: TOGETHER_DEFAULT, envKeys: ["TOGETHER_API_KEY"] },
   fireworks: { label: "Fireworks", baseUrl: "https://api.fireworks.ai/inference/v1", model: FIREWORKS_DEFAULT, envKeys: ["FIREWORKS_API_KEY"] },
   // Local / self-hosted
+  apple: { label: "Apple Intelligence", model: "on-device", envKeys: [], local: true },
   ollama: { label: "Ollama", baseUrl: "http://localhost:11434/v1", envKeys: [], local: true },
   lmstudio: { label: "LM Studio", baseUrl: "http://localhost:1234/v1", envKeys: [], local: true },
   llamacpp: { label: "llama.cpp", baseUrl: "http://localhost:8080/v1", envKeys: [], local: true },
@@ -1352,28 +1524,62 @@ async function firstServerModel(baseUrl, apiKey) {
 }
 function noProviderHints() {
   return [
+    "On a Mac with Apple Intelligence (macOS 26+), the on-device model is used automatically",
     `Set one of ${AI_ENV_KEYS.join(", ")}, or pass --ai-key`,
     "Or run a local model: start Ollama (https://ollama.com) and `ollama pull llama3.2` - it is picked up automatically",
     "Or point at any OpenAI-compatible server: --ai-base-url http://localhost:8080/v1 --ai-model <name>"
   ];
 }
-async function resolveAIProvider(opts, env = process.env, probe = probeOllama) {
-  let provider = opts.aiProvider?.trim().toLowerCase();
+function appleResolution(status, notice) {
+  const preset = AI_PROVIDERS.apple;
+  return {
+    ok: true,
+    ai: {
+      provider: "apple",
+      label: preset.label,
+      baseUrl: "",
+      model: preset.model,
+      jsonMode: false,
+      anthropic: false,
+      local: true,
+      helper: status.helper,
+      notice
+    }
+  };
+}
+async function resolveAIProvider(opts, env = process.env, probe = probeOllama, probeApple = checkAppleAI) {
+  const requested = opts.aiProvider?.trim() || (!opts.aiKey && !opts.aiBaseUrl ? env.RANKCLI_AI_PROVIDER?.trim() : void 0);
+  let provider = requested?.toLowerCase();
   let notice;
   let ollamaModels = null;
   if (provider && !AI_PROVIDERS[provider]) {
     return {
       ok: false,
-      error: `Unknown AI provider "${opts.aiProvider}"`,
+      error: `Unknown AI provider "${requested}"`,
       hints: [`Choose one of: ${AI_PROVIDER_IDS.join(", ")}`]
     };
   }
+  if (provider === "apple") {
+    const apple = await probeApple(env);
+    if (!apple.available) {
+      return {
+        ok: false,
+        error: `Apple Intelligence isn't available: ${apple.reason}`,
+        hints: ["Choose another provider with --ai-provider (e.g. openrouter, ollama)"]
+      };
+    }
+    return appleResolution(apple);
+  }
   if (!provider) {
     if (opts.aiBaseUrl) {
       provider = "custom";
     } else if (opts.aiKey) {
       provider = providerFromKey(opts.aiKey) ?? "openai";
     } else {
+      const apple = await probeApple(env);
+      if (apple.available) {
+        return appleResolution(apple, "Using Apple Intelligence on this Mac (on-device, free) - pass --ai-provider to use another");
+      }
       provider = DETECT_ORDER.find((id) => AI_PROVIDERS[id].envKeys.some((k) => env[k]));
     }
   }
@@ -1513,9 +1719,11 @@ function normalizeAnalysis(raw) {
 }
 var SEVERITY_ORDER = { critical: 0, error: 1, warning: 2, notice: 3, info: 3 };
 var MAX_ISSUES_IN_PROMPT = 60;
-function buildPrompt(url, issues) {
+var APPLE_MAX_ISSUES = 25;
+var APPLE_MAX_TOKENS = 1200;
+function buildPrompt(url, issues, maxIssues = MAX_ISSUES_IN_PROMPT) {
   const ranked = [...issues].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4));
-  const shown = ranked.slice(0, MAX_ISSUES_IN_PROMPT);
+  const shown = ranked.slice(0, maxIssues);
   const more = ranked.length > shown.length ? `
 (${ranked.length - shown.length} lower-severity issues omitted)` : "";
   return `Analyze these SEO audit results and provide prioritized recommendations:
@@ -1535,10 +1743,27 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const prompt = buildPrompt(url, issues);
-  const system = "You are an SEO expert. Respond with valid JSON only.";
+  const reply = await completeWithAI(ai, {
+    system: "You are an SEO expert. Respond with valid JSON only.",
+    prompt: buildPrompt(url, issues, ai.provider === "apple" ? APPLE_MAX_ISSUES : MAX_ISSUES_IN_PROMPT),
+    json: true
+  });
+  if ("error" in reply) return reply;
+  return parseAnalysis(reply.text, ai);
+}
+async function completeWithAI(ai, request) {
+  const { system, prompt } = request;
+  if (ai.provider === "apple" && ai.helper) {
+    const reply = await generateWithAppleAI(ai.helper, {
+      system,
+      prompt,
+      maxTokens: Math.min(request.maxTokens ?? APPLE_MAX_TOKENS, APPLE_MAX_TOKENS)
+    });
+    if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
+    return reply;
+  }
   const timeoutMs = ai.local ? 3e5 : 9e4;
-  const maxTokens = 4096;
+  const maxTokens = Math.max(request.maxTokens ?? 4096, 4096);
   const headers = { "Content-Type": "application/json" };
   let endpoint;
   let body;
@@ -1546,7 +1771,7 @@ async function runAIAnalysis(url, issues, ai) {
     endpoint = `${ai.baseUrl}/messages`;
     headers["x-api-key"] = ai.apiKey || "";
     headers["anthropic-version"] = "2023-06-01";
-    body = { model: ai.model, max_tokens: maxTokens, system, messages: [{ role: "user", content: prompt }] };
+    body = { model: ai.model, max_tokens: maxTokens, ...system ? { system } : {}, messages: [{ role: "user", content: prompt }] };
   } else {
     endpoint = `${ai.baseUrl}/chat/completions`;
     if (ai.apiKey) headers["Authorization"] = `Bearer ${ai.apiKey}`;
@@ -1557,12 +1782,12 @@ async function runAIAnalysis(url, issues, ai) {
     body = {
       model: ai.model,
       messages: [
-        { role: "system", content: system },
+        ...system ? [{ role: "system", content: system }] : [],
         { role: "user", content: prompt }
       ],
       // OpenAI's GPT-5.6 rejects max_tokens (and temperature); everyone else expects max_tokens.
       ...ai.provider === "openai" && !ai.local ? { max_completion_tokens: maxTokens } : { max_tokens: maxTokens },
-      ...ai.jsonMode ? { response_format: { type: "json_object" } } : {}
+      ...ai.jsonMode && request.json ? { response_format: { type: "json_object" } } : {}
     };
   }
   let response;
@@ -1586,6 +1811,9 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
+  return { text: content };
+}
+function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
   const analysis = parsed ? normalizeAnalysis(parsed) : null;
   if (!analysis) {
@@ -2059,8 +2287,8 @@ Examples:
 `;
 
 // src/commands/apply.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
 import {
   runAuditWithFixes,
   generateFixes,
@@ -2094,11 +2322,11 @@ function truncate(str, maxLen) {
 }
 async function apply(options) {
   const cwd = process.cwd();
-  const configPath = join4(cwd, "rankcli.config.json");
+  const configPath = join5(cwd, "rankcli.config.json");
   let config2 = null;
-  if (existsSync4(configPath)) {
+  if (existsSync5(configPath)) {
     try {
-      config2 = JSON.parse(readFileSync4(configPath, "utf-8"));
+      config2 = JSON.parse(readFileSync5(configPath, "utf-8"));
     } catch {
     }
   }
@@ -2222,7 +2450,7 @@ async function apply(options) {
   }
   if (config2 && !config2.url) {
     config2.url = url;
-    writeFileSync3(configPath, JSON.stringify(config2, null, 2));
+    writeFileSync4(configPath, JSON.stringify(config2, null, 2));
     console.log("\n\u{1F4BE} Updated config with URL.");
   }
   console.log("\n" + "\u2500".repeat(50));
@@ -2849,7 +3077,7 @@ async function trackHistory(options) {
     }
     const days = options.days || 30;
     const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
-    const { data: historyData, error } = await supabase.from("rankings").select("position, url, recorded_at").eq("keyword_id", keywordData.id).gte("recorded_at", cutoff.toISOString()).order("recorded_at", { ascending: false });
+    const { data: historyData, error } = await supabase.from("keyword_position_history").select("position, url, checked_at").eq("keyword_id", keywordData.id).gte("checked_at", cutoff.toISOString()).order("checked_at", { ascending: false });
     if (error) {
       spinner.fail(`Failed to load history: ${error.message}`);
       return { success: false, error: error.message };
@@ -2858,7 +3086,7 @@ async function trackHistory(options) {
     const history = (historyData || []).map((row) => ({
       position: row.position,
       url: row.url,
-      recordedAt: new Date(row.recorded_at)
+      recordedAt: new Date(row.checked_at)
     }));
     if (options.output === "json") {
       console.log(JSON.stringify({ keyword: options.keyword, history }, null, 2));
@@ -2866,7 +3094,9 @@ async function trackHistory(options) {
       console.log("\n" + chalk6.bold(`\u{1F4C8} History: "${options.keyword}"`));
       console.log("\u2550".repeat(50));
       if (history.length === 0) {
-        console.log(chalk6.dim("\nNo history available yet.\n"));
+        console.log(chalk6.dim(`
+No checks recorded yet. Run 'rankcli track check --url <your site>' to record one.
+`));
       } else {
         const positions = history.slice(0, 30).reverse().map((h) => h.position || 101);
         const sparkline = positions.map((p) => {
@@ -2877,7 +3107,7 @@ async function trackHistory(options) {
         }).join("");
         console.log(`
   ${sparkline}  (last ${positions.length} checks)`);
-        console.log(chalk6.dim("  \u2190 newer                    older \u2192\n"));
+        console.log(chalk6.dim("  \u2190 older                    newer \u2192\n"));
         const recent = history.slice(0, 10);
         for (const entry of recent) {
           console.log(`  ${entry.recordedAt.toLocaleDateString()}  ${formatPosition(entry.position)}`);
@@ -3201,6 +3431,40 @@ import {
   formatTopicReport,
   runAIKeywordResearch
 } from "@rankcli/agent-runtime";
+
+// src/lib/keyword-llm.ts
+async function openAIEmbeddings(ai, texts) {
+  const response = await fetch(`${ai.baseUrl}/embeddings`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${ai.apiKey}` },
+    body: JSON.stringify({ model: "text-embedding-3-small", input: texts }),
+    signal: AbortSignal.timeout(6e4)
+  });
+  if (!response.ok) throw new Error(`OpenAI embeddings returned HTTP ${response.status}`);
+  const data = await response.json();
+  return data.data.map((item) => item.embedding);
+}
+function keywordLLMFromAI(ai) {
+  const llm = {
+    async complete(prompt, opts = {}) {
+      const reply = await completeWithAI(ai, { system: opts.system, prompt, maxTokens: opts.maxTokens, json: true });
+      if ("error" in reply) throw new Error(reply.error);
+      return reply.text;
+    }
+  };
+  if (ai.provider === "openai" && ai.apiKey && ai.jsonMode) {
+    llm.embed = (texts) => openAIEmbeddings(ai, texts);
+  }
+  if (ai.provider === "apple") {
+    llm.maxContentChars = 5e3;
+    llm.maxToolIdeas = 5;
+  } else if (ai.local) {
+    llm.maxToolIdeas = 5;
+  }
+  return llm;
+}
+
+// src/commands/keywords.ts
 async function keywords(options) {
   console.log("\n\u{1F511} RankCLI - Keyword Research\n");
   console.log("This tool helps you find keywords you can actually rank for,");
@@ -3361,65 +3625,37 @@ async function keywordsQuick(url, providedSeeds) {
 `);
   }
 }
-var SUPABASE_URL = "https://eqzlmjbvrtrglknphdai.supabase.co";
 async function keywordsAI(url, options = {}) {
   console.log("\n\u{1F916} AI-Powered Keyword Research\n");
-  console.log("This uses GPT-4 to analyze your site and generate keyword recommendations");
-  console.log("with competitive analysis and free tool ideas.\n");
-  const openaiApiKey = options.openaiApiKey || process.env.OPENAI_API_KEY;
   try {
     const parsed = new URL(url.startsWith("http") ? url : `https://${url}`);
     url = parsed.href;
-    console.log(`\u{1F4CD} Analyzing: ${url}`);
-    console.log("");
-    if (!options.forceLocal) {
-      console.log("\u{1F517} Connecting to RankCLI cloud...");
-      try {
-        const response = await fetch(`${SUPABASE_URL}/functions/v1/ai-keywords`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-            // Auth header would go here if user is logged in
-          },
-          body: JSON.stringify({
-            url,
-            mode: "analyze"
-          })
-        });
-        if (response.ok) {
-          const result2 = await response.json();
-          if (result2.tier === "free" && result2.teaser) {
-            console.log("\n" + "\u2500".repeat(60));
-            console.log("\u{1F512} FREE TIER - Limited Preview");
-            console.log("\u2500".repeat(60));
-            console.log(`Found ${result2.teaser.totalKeywordsFound} keywords`);
-            console.log(`Top keywords: ${result2.teaser.topKeywords.join(", ")}`);
-            console.log(`
-${result2.teaser.upgradeMessage}`);
-            console.log('\n\u{1F4A1} Run "rankcli login" to access your paid plan features.\n');
-            return;
-          }
-          displayAIKeywordResults(result2);
-          return;
-        } else {
-          const errorText = await response.text();
-          console.log(`\u26A0\uFE0F  Cloud request failed, running locally...
-`);
-        }
-      } catch (err) {
-        console.log("\u26A0\uFE0F  Cloud unavailable, running locally...\n");
-      }
+    const resolution = await resolveAIProvider(options);
+    if (!resolution.ok) {
+      console.log(`\u274C ${resolution.error}`);
+      for (const hint of resolution.hints) console.log(`   ${hint}`);
+      console.log("");
+      process.exitCode = 1;
+      return;
     }
-    if (!openaiApiKey) {
-      console.log("\u274C OpenAI API key required for local processing.");
-      console.log('   Set OPENAI_API_KEY environment variable, or use "rankcli login" for cloud processing.\n');
+    const { ai } = resolution;
+    if (ai.notice) console.log(ai.notice);
+    const check = await completeWithAI(ai, { prompt: 'Reply with the JSON object {"ok": true} and nothing else.', maxTokens: 50, json: true });
+    if ("error" in check) {
+      console.log(`\u274C ${check.error}`);
+      console.log("   Choose another provider with --ai-provider, or fix the key or model and try again.\n");
+      process.exitCode = 1;
       return;
     }
-    console.log("\u{1F52C} Running local AI analysis (this may take a minute)...\n");
+    console.log(`\u{1F4CD} Analyzing: ${url}`);
+    console.log(`\u{1F9E0} Model: ${ai.label} (${ai.model})
+`);
+    console.log(`\u{1F52C} Running AI analysis (${ai.local ? "a few minutes on a local model" : "this may take a minute"})...
+`);
     const result = await runAIKeywordResearch({
       url,
       tier: "solo",
-      openaiApiKey,
+      llm: keywordLLMFromAI(ai),
       enableEnhancedToolIdeas: true,
       competitiveSearchKeys: {
         braveApiKey: process.env.BRAVE_API_KEY,
@@ -3432,6 +3668,7 @@ ${result2.teaser.upgradeMessage}`);
     console.log(`
 \u274C Error: ${error instanceof Error ? error.message : "Unknown error"}
 `);
+    process.exitCode = 1;
   }
 }
 function displayAIKeywordResults(result) {
@@ -3858,7 +4095,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.31";
+var VERSION = "0.0.33";
 
 // src/index.ts
 var program = new Command();
@@ -3870,7 +4107,7 @@ program.command("logout").description("Log out of your RankCLI account").action(
 program.command("whoami").description("Show current logged in user").action(whoami);
 program.command("init").description("Set up RankCLI in your project (detects framework, git/GitHub, AI keys)").option("-y, --yes", "Skip prompts and use defaults").action(init);
 program.command("analyze").description("AI analyzes your codebase for SEO opportunities").option("-v, --verbose", "Show detailed output").action(analyze);
-program.command("audit").description("Run a comprehensive SEO audit (200+ checks, Ahrefs-level)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted): openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
+program.command("audit").description("Run an SEO + GEO audit (280+ checks)").option("-u, --url <url>", "URL to audit").option("-o, --output <format>", "Output format (json, console)", "console").option("--check-links", "Check for broken internal/external links (slower)").option("--max-pages <n>", "Max pages to crawl (default: 5)").option("--fail-on <level>", "CI gate: exit 1 if any issue is at or above this severity (error, warning, notice)").option("--min-score <n>", "CI gate: exit 1 if the overall score is below n (0-100)").option("--ai", "Enable AI analysis (your own key, or a local model)").option("--ai-provider <provider>", "AI provider (auto-detected if omitted; Apple Intelligence on a Mac that has it, or set RANKCLI_AI_PROVIDER): apple, openrouter, openai, anthropic, groq, gemini, deepseek, mistral, cerebras, together, fireworks, ollama, lmstudio, llamacpp, vllm, custom").option("--ai-key <key>", "AI provider API key (or set the provider's env var, e.g. OPENROUTER_API_KEY)").option("--ai-model <model>", "Model id (defaults to a cheap model per provider, or the local server's loaded model)").option("--ai-base-url <url>", "OpenAI-compatible base URL, e.g. http://localhost:8080/v1 (implies --ai-provider custom)").addHelpText("after", AUDIT_HELP_TEXT).action(async (options) => {
   process.exitCode = await audit(options);
 });
 program.command("apply").description("Analyze a live URL and apply SEO fixes to your codebase").option("-u, --url <url>", "URL to analyze").option("--auto", "Auto-apply fixes without confirmation").option("--dry-run", "Preview changes without applying").action(apply);
@@ -3889,11 +4126,13 @@ program.command("fix").description("Agentic SEO fixer - detect, fix, commit, and
   }
 });
 program.command("geo").description("GEO analysis - Check AI search visibility (ChatGPT, Perplexity, Claude)").option("-u, --url <url>", "URL to analyze").option("-o, --output <format>", "Output format (json, console)", "console").action(geo);
-program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "Use GPT-4 for enhanced analysis with free tool ideas").option("--local", "Force local processing (skip cloud worker)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
+program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "AI keyword research with free tool ideas, on your own provider (Apple Intelligence on a Mac that has it)").option("--ai-provider <provider>", "AI provider for --ai (auto-detected if omitted, or set RANKCLI_AI_PROVIDER)").option("--ai-key <key>", "AI provider API key (or the provider's env var)").option("--ai-model <model>", "Override the provider's default model").option("--ai-base-url <url>", "Any OpenAI-compatible server (implies --ai-provider custom)").option("--local", "No effect; --ai always runs locally on your provider (kept for old scripts)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
   if (options.ai && options.url) {
     await keywordsAI(options.url, {
-      forceLocal: options.local,
-      openaiApiKey: process.env.OPENAI_API_KEY
+      aiProvider: options.aiProvider,
+      aiKey: options.aiKey,
+      aiModel: options.aiModel,
+      aiBaseUrl: options.aiBaseUrl
     });
   } else if (options.competitor && options.url && options.seed) {
     const seeds = options.seed.split(",").map((s) => s.trim());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/cli",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "description": "RankCLI - Ship code, get ranked. SEO meets CI/CD.",
   "homepage": "https://rankcli.dev",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "update-version": "node scripts/update-version.js"
   },
   "dependencies": {
-    "@rankcli/agent-runtime": "^0.0.22",
+    "@rankcli/agent-runtime": "^0.0.24",
     "@supabase/supabase-js": "^2.98.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",