@flydocs/cli 0.5.0-beta.9 → 0.6.0-alpha.2

package/dist/cli.js

@@ -11,13 +11,14 @@ var __export = (target, all) => {
 
 // src/lib/constants.ts
 import pc from "picocolors";
-var CLI_VERSION, CLI_NAME, PACKAGE_NAME;
+var CLI_VERSION, CLI_NAME, PACKAGE_NAME, POSTHOG_API_KEY;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.5.0-beta.9";
+    CLI_VERSION = "0.6.0-alpha.2";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
+    POSTHOG_API_KEY = "phc_v1MSJTQDFkMS90CBh3mxIz3v8bYCCnKU6v1ir6bz0Xn";
   }
 });
 
@@ -42,9 +43,7 @@ async function ensureDirectories(targetDir, tier) {
   const dirs = [
     ".flydocs",
     ".claude/skills",
-    ".claude/agents",
     ".claude/commands",
-    ".cursor/agents",
     ".cursor/commands",
     ".cursor/rules",
     "flydocs/context",
@@ -136,8 +135,58 @@ var init_template = __esm({
 
 // src/lib/ui.ts
 import pc2 from "picocolors";
-function hyperlink(text3, url) {
-  return `\x1B]8;;${url}\x1B\\${text3}\x1B]8;;\x1B\\`;
+function shadow(text3) {
+  return `\x1B[38;2;55;45;70m${text3}\x1B[0m`;
+}
+function renderBannerBlock() {
+  const height = BANNER_ROWS.length;
+  const width = BANNER_ROWS[0].length;
+  const padded = BANNER_ROWS.map((r) => r.padEnd(width));
+  console.log(`  ${GRADIENT[0](padded[0])}`);
+  for (let i = 1; i < height; i++) {
+    let line = "";
+    const shadowSrc2 = padded[i - 1];
+    const textSrc = padded[i];
+    for (let c = 0; c < width; c++) {
+      const textChar = textSrc[c];
+      const shadowChar = c > 0 ? shadowSrc2[c - 1] : " ";
+      if (textChar === "\u2588") {
+        line += "\u2588";
+      } else if (shadowChar === "\u2588") {
+        line += "\u2593";
+      } else {
+        line += " ";
+      }
+    }
+    let colored = "  ";
+    let j = 0;
+    while (j < line.length) {
+      const ch = line[j];
+      let run = "";
+      while (j < line.length && line[j] === ch) {
+        run += line[j];
+        j++;
+      }
+      if (ch === "\u2588") {
+        colored += GRADIENT[i](run);
+      } else if (ch === "\u2593") {
+        colored += shadow(run);
+      } else {
+        colored += run;
+      }
+    }
+    console.log(colored);
+  }
+  const shadowSrc = padded[height - 1];
+  let bottomShadow = "";
+  for (let c = 0; c < width + 1; c++) {
+    const shadowChar = c > 0 ? shadowSrc[c - 1] : " ";
+    bottomShadow += shadowChar === "\u2588" ? "\u2593" : " ";
+  }
+  bottomShadow = bottomShadow.replace(/\s+$/, "");
+  if (bottomShadow.trim()) {
+    console.log(`  ${shadow(" " + bottomShadow)}`);
+  }
 }
 function printStatus(message) {
   console.log(`${pc2.green("\u2714")} ${message}`);
@@ -152,26 +201,13 @@ function printInfo(message) {
   console.log(`${pc2.cyan("\u2139")} ${message}`);
 }
 function printBanner(version) {
-  const pink = (t) => pc2.bold(pc2.magenta(t));
-  const purple = (t) => pc2.bold(pc2.cyan(t));
-  const dim = pc2.dim;
-  const bold = pc2.bold;
-  const pinkBlock12 = pink("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588");
-  const pinkBlock4 = pink("\u2588\u2588\u2588\u2588");
-  const purpleBlock12 = purple("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588");
-  const purpleBlock4 = purple("\u2588\u2588\u2588\u2588");
   console.log();
-  console.log(`  ${pinkBlock12}`);
-  console.log(`  ${pinkBlock12}`);
-  console.log(`  ${pinkBlock4}`);
-  console.log(
-    `  ${pinkBlock4}  ${purpleBlock12}  ${bold("FlyDocs")} ${dim("(Beta)")}`
-  );
+  renderBannerBlock();
+  console.log();
   console.log(
-    `        ${purpleBlock12}  ${dim("Spec-Driven Context That Helps Engineers Fly")}`
+    `  ${pc2.bold(pc2.white("Structured context for AI coding tools"))}  ${pc2.dim("(Beta)")}`
   );
-  console.log(`        ${purpleBlock4}`);
-  console.log(`        ${purpleBlock4}          ${dim(`v${version}`)}`);
+  console.log(`  ${pc2.dim(`Version: ${version}`)}`);
   console.log();
 }
 function printCompletionBox(title, lines) {
@@ -192,22 +228,42 @@ function printCompletionBox(title, lines) {
 }
 function printBetaCta() {
   const dim = pc2.dim;
-  const url = "https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta";
+  const discordUrl = "https://discord.com/invite/YAkjePmZTQ";
+  const siteUrl = "https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta";
   console.log(
     dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")
   );
   console.log();
-  console.log(`  ${pc2.bold("Join the FlyDocs Closed Beta")}`);
   console.log(
-    `  ${dim("Early access to cloud features, web portal, and more.")}`
+    `  ${pc2.bold(pc2.cyan("Join the Discord"))} for upcoming features, support, and early access to what's next.`
+  );
+  console.log(`  ${dim("Invite link:")}`);
+  console.log(`  ${pc2.cyan(discordUrl)}`);
+  console.log();
+  console.log(
+    `  ${dim("Docs and updates:")} ${pc2.cyan("https://www.flydocs.ai")}`
   );
-  console.log(`  ${pc2.cyan(hyperlink("flydocs.ai", url))}`);
   console.log();
 }
+var GRADIENT, BANNER_ROWS;
 var init_ui = __esm({
   "src/lib/ui.ts"() {
     "use strict";
     init_constants();
+    GRADIENT = [
+      (t) => `\x1B[1;38;2;255;0;128m${t}\x1B[0m`,
+      (t) => `\x1B[1;38;2;225;15;158m${t}\x1B[0m`,
+      (t) => `\x1B[1;38;2;190;30;190m${t}\x1B[0m`,
+      (t) => `\x1B[1;38;2;158;44;214m${t}\x1B[0m`,
+      (t) => `\x1B[1;38;2;124;58;237m${t}\x1B[0m`
+    ];
+    BANNER_ROWS = [
+      "\u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588    \u2588\u2588  \u2588\u2588 \u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588  \u2588\u2588\u2588\u2588\u2588\u2588",
+      "\u2588\u2588     \u2588\u2588     \u2588\u2588\u2588\u2588  \u2588\u2588  \u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588     \u2588\u2588    ",
+      "\u2588\u2588\u2588\u2588\u2588  \u2588\u2588      \u2588\u2588   \u2588\u2588  \u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588      \u2588\u2588\u2588\u2588 ",
+      "\u2588\u2588     \u2588\u2588      \u2588\u2588   \u2588\u2588  \u2588\u2588 \u2588\u2588  \u2588\u2588 \u2588\u2588         \u2588\u2588",
+      "\u2588\u2588     \u2588\u2588\u2588\u2588\u2588\u2588  \u2588\u2588   \u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588  \u2588\u2588\u2588\u2588\u2588\u2588"
+    ];
   }
 });
 
@@ -305,18 +361,26 @@ async function installOwnedSkills(templateDir, targetDir, tier) {
     join4(templateSkillsDir, activeMech),
     join4(skillsDir, activeMech)
   );
-  const { rm: rm5 } = await import("fs/promises");
+  const { rm: rm6 } = await import("fs/promises");
   const inactivePath = join4(skillsDir, inactiveMech);
   if (await pathExists(inactivePath)) {
-    await rm5(inactivePath, { recursive: true, force: true });
+    await rm6(inactivePath, { recursive: true, force: true });
   }
-  for (const skill of OWNED_SKILLS) {
+  for (const skill of CORE_SKILLS) {
     if (skill === "flydocs-workflow") continue;
     const src = join4(templateSkillsDir, skill);
     if (await pathExists(src)) {
       await replaceDirectory(src, join4(skillsDir, skill));
     }
   }
+  if (tier === "cloud") {
+    for (const skill of CLOUD_ONLY_SKILLS) {
+      const src = join4(templateSkillsDir, skill);
+      if (await pathExists(src)) {
+        await replaceDirectory(src, join4(skillsDir, skill));
+      }
+    }
+  }
   const readmeSrc = join4(templateSkillsDir, "README.md");
   if (await pathExists(readmeSrc)) {
     await copyFile(readmeSrc, join4(skillsDir, "README.md"));
@@ -325,18 +389,29 @@ async function installOwnedSkills(templateDir, targetDir, tier) {
 async function replaceOwnedSkills(templateDir, targetDir, tier) {
   const skillsDir = join4(targetDir, ".claude", "skills");
   const templateSkillsDir = join4(templateDir, ".claude", "skills");
-  for (const skill of OWNED_SKILLS) {
+  const { rm: rm6 } = await import("fs/promises");
+  for (const skill of CORE_SKILLS) {
     const src = join4(templateSkillsDir, skill);
     if (await pathExists(src)) {
       await replaceDirectory(src, join4(skillsDir, skill));
     }
   }
-  const { rm: rm5 } = await import("fs/promises");
+  for (const skill of CLOUD_ONLY_SKILLS) {
+    const dest = join4(skillsDir, skill);
+    if (tier === "cloud") {
+      const src = join4(templateSkillsDir, skill);
+      if (await pathExists(src)) {
+        await replaceDirectory(src, dest);
+      }
+    } else if (await pathExists(dest)) {
+      await rm6(dest, { recursive: true, force: true });
+    }
+  }
   const activeMech = MECHANISM_SKILLS[tier];
   const inactiveMech = tier === "local" ? MECHANISM_SKILLS.cloud : MECHANISM_SKILLS.local;
   const inactivePath = join4(skillsDir, inactiveMech);
   if (await pathExists(inactivePath)) {
-    await rm5(inactivePath, { recursive: true, force: true });
+    await rm6(inactivePath, { recursive: true, force: true });
   }
   await replaceDirectory(
     join4(templateSkillsDir, activeMech),
@@ -348,9 +423,9 @@ async function replaceOwnedSkills(templateDir, targetDir, tier) {
   }
 }
 async function copyCursorRules(targetDir) {
-  const { mkdir: mkdir6 } = await import("fs/promises");
+  const { mkdir: mkdir9 } = await import("fs/promises");
   const rulesDir = join4(targetDir, ".cursor", "rules");
-  await mkdir6(rulesDir, { recursive: true });
+  await mkdir9(rulesDir, { recursive: true });
   const workflowRule = join4(
     targetDir,
     ".claude",
@@ -384,18 +459,17 @@ async function copyCursorRules(targetDir) {
     await copyFile(context7Rule, join4(rulesDir, "flydocs-context7.mdc"));
   }
 }
-var OWNED_SKILLS, MECHANISM_SKILLS;
+var CORE_SKILLS, CLOUD_ONLY_SKILLS, MECHANISM_SKILLS;
 var init_skills = __esm({
   "src/lib/skills.ts"() {
     "use strict";
     init_fs_ops();
-    OWNED_SKILLS = [
+    CORE_SKILLS = [
       "flydocs-workflow",
-      "flydocs-figma",
-      "flydocs-estimates",
       "flydocs-context-graph",
       "flydocs-context7"
     ];
+    CLOUD_ONLY_SKILLS = ["flydocs-figma", "flydocs-estimates"];
     MECHANISM_SKILLS = {
       local: "flydocs-local",
       cloud: "flydocs-cloud"
@@ -403,14 +477,77 @@ var init_skills = __esm({
   }
 });
 
+// src/lib/user-content.ts
+import {
+  copyFile as fsCopyFile2,
+  mkdir as mkdir2,
+  readFile as readFile3,
+  writeFile as writeFile2
+} from "fs/promises";
+import { join as join5, dirname as dirname2 } from "path";
+async function backupOriginals(targetDir, files = RESTORABLE_FILES) {
+  const backedUp = [];
+  const backupDir = join5(targetDir, BACKUP_ORIGINALS_DIR);
+  for (const relativePath of files) {
+    const srcPath = join5(targetDir, relativePath);
+    const destPath = join5(backupDir, relativePath);
+    if (!await pathExists(srcPath)) {
+      continue;
+    }
+    if (await pathExists(destPath)) {
+      continue;
+    }
+    await mkdir2(dirname2(destPath), { recursive: true });
+    await fsCopyFile2(srcPath, destPath);
+    backedUp.push(relativePath);
+  }
+  return backedUp;
+}
+async function readBackupOriginals(targetDir) {
+  const backupDir = join5(targetDir, BACKUP_ORIGINALS_DIR);
+  if (!await pathExists(backupDir)) {
+    return [];
+  }
+  const files = [];
+  for (const relativePath of RESTORABLE_FILES) {
+    const backupPath = join5(backupDir, relativePath);
+    if (await pathExists(backupPath)) {
+      const content = await readFile3(backupPath);
+      files.push({ relativePath, content });
+    }
+  }
+  return files;
+}
+async function writeRestoredFiles(targetDir, files) {
+  for (const { relativePath, content } of files) {
+    const destPath = join5(targetDir, relativePath);
+    await mkdir2(dirname2(destPath), { recursive: true });
+    await writeFile2(destPath, content);
+  }
+}
+var BACKUP_ORIGINALS_DIR, RESTORABLE_FILES;
+var init_user_content = __esm({
+  "src/lib/user-content.ts"() {
+    "use strict";
+    init_fs_ops();
+    BACKUP_ORIGINALS_DIR = ".flydocs/backup-originals";
+    RESTORABLE_FILES = [
+      ".claude/CLAUDE.md",
+      ".claude/settings.json",
+      ".cursor/hooks.json",
+      "AGENTS.md"
+    ];
+  }
+});
+
 // src/lib/stack.ts
-import { readFile as readFile3 } from "fs/promises";
-import { join as join5 } from "path";
+import { readFile as readFile4 } from "fs/promises";
+import { join as join6 } from "path";
 async function parseProjectMdStack(targetDir) {
   const detected = /* @__PURE__ */ new Set();
-  const projectMdPath = join5(targetDir, "flydocs", "context", "project.md");
+  const projectMdPath = join6(targetDir, "flydocs", "context", "project.md");
   try {
-    const content = await readFile3(projectMdPath, "utf-8");
+    const content = await readFile4(projectMdPath, "utf-8");
     const stackMatch = content.match(/## Stack\n([\s\S]*?)(?=\n## |\n---|\z)/);
     if (!stackMatch) return detected;
     const stackSection = stackMatch[1].toLowerCase();
@@ -453,10 +590,10 @@ async function parseProjectMdStack(targetDir) {
 }
 async function detectStack(targetDir) {
   const detected = /* @__PURE__ */ new Set();
-  const pkgPath = join5(targetDir, "package.json");
+  const pkgPath = join6(targetDir, "package.json");
   let pkg;
   try {
-    const content = await readFile3(pkgPath, "utf-8");
+    const content = await readFile4(pkgPath, "utf-8");
     pkg = JSON.parse(content);
   } catch {
   }
@@ -484,39 +621,39 @@ async function detectStack(targetDir) {
       detected.add("testing-library");
   }
   for (const f of ["convex/schema.ts", "convex/schema.js"]) {
-    if (await pathExists(join5(targetDir, f))) detected.add("convex");
+    if (await pathExists(join6(targetDir, f))) detected.add("convex");
   }
   for (const f of ["next.config.ts", "next.config.js", "next.config.mjs"]) {
-    if (await pathExists(join5(targetDir, f))) detected.add("nextjs");
+    if (await pathExists(join6(targetDir, f))) detected.add("nextjs");
   }
-  const appJsonPath = join5(targetDir, "app.json");
+  const appJsonPath = join6(targetDir, "app.json");
   if (await pathExists(appJsonPath)) {
     try {
-      const appContent = await readFile3(appJsonPath, "utf-8");
+      const appContent = await readFile4(appJsonPath, "utf-8");
       if (appContent.includes('"expo"')) detected.add("expo");
     } catch {
     }
   }
-  if (await pathExists(join5(targetDir, "tsconfig.json"))) {
+  if (await pathExists(join6(targetDir, "tsconfig.json"))) {
     detected.add("typescript");
   }
-  if (await pathExists(join5(targetDir, "nuxt.config.ts")) || await pathExists(join5(targetDir, "nuxt.config.js"))) {
+  if (await pathExists(join6(targetDir, "nuxt.config.ts")) || await pathExists(join6(targetDir, "nuxt.config.js"))) {
     detected.add("nuxt");
     detected.add("vue");
   }
-  if (await pathExists(join5(targetDir, "angular.json"))) {
+  if (await pathExists(join6(targetDir, "angular.json"))) {
     detected.add("angular");
   }
-  if (await pathExists(join5(targetDir, "svelte.config.js")) || await pathExists(join5(targetDir, "svelte.config.ts"))) {
+  if (await pathExists(join6(targetDir, "svelte.config.js")) || await pathExists(join6(targetDir, "svelte.config.ts"))) {
     detected.add("svelte");
   }
-  if (await pathExists(join5(targetDir, "pyproject.toml")) || await pathExists(join5(targetDir, "requirements.txt")) || await pathExists(join5(targetDir, "setup.py"))) {
+  if (await pathExists(join6(targetDir, "pyproject.toml")) || await pathExists(join6(targetDir, "requirements.txt")) || await pathExists(join6(targetDir, "setup.py"))) {
     detected.add("python");
   }
-  if (await pathExists(join5(targetDir, "go.mod"))) {
+  if (await pathExists(join6(targetDir, "go.mod"))) {
     detected.add("go");
   }
-  if (await pathExists(join5(targetDir, "Cargo.toml"))) {
+  if (await pathExists(join6(targetDir, "Cargo.toml"))) {
     detected.add("rust");
   }
   const projectMdStack = await parseProjectMdStack(targetDir);
@@ -562,9 +699,9 @@ var init_stack = __esm({
 
 // src/lib/post-install.ts
 import { execFileSync } from "child_process";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 async function runManifestGeneration(targetDir) {
-  const scriptPath = join6(
+  const scriptPath = join7(
     targetDir,
     ".flydocs",
     "scripts",
@@ -582,7 +719,7 @@ async function runManifestGeneration(targetDir) {
   }
 }
 async function runContextGraphBuild(targetDir) {
-  const scriptPath = join6(
+  const scriptPath = join7(
     targetDir,
     ".claude",
     "skills",
@@ -610,8 +747,8 @@ var init_post_install = __esm({
 });
 
 // src/lib/skill-manager.ts
-import { readFile as readFile4, readdir, rm as rm2, mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
-import { join as join7 } from "path";
+import { readFile as readFile5, readdir, rm as rm2, mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
+import { join as join8 } from "path";
 import pc3 from "picocolors";
 function flushFrontmatterValue(mode, lines) {
   switch (mode) {
@@ -738,13 +875,13 @@ async function downloadFileContent(downloadUrl) {
 async function downloadRecursive(url, destDir) {
   const items = await fetchGitHubJson(url);
   if (items === null) return false;
-  await mkdir2(destDir, { recursive: true });
+  await mkdir3(destDir, { recursive: true });
   for (const item of items) {
-    const destPath = join7(destDir, item.name);
+    const destPath = join8(destDir, item.name);
     if (item.type === "file") {
       if (item.download_url) {
         const content = await downloadFileContent(item.download_url);
-        await writeFile2(destPath, content);
+        await writeFile3(destPath, content);
       }
     } else if (item.type === "dir") {
       await downloadRecursive(item.url, destPath);
@@ -757,7 +894,7 @@ async function downloadSkillTree(repo, skillName, targetDir) {
   return downloadRecursive(apiUrl, targetDir);
 }
 async function listSkills(targetDir) {
-  const skillsDir = join7(targetDir, ".claude", "skills");
+  const skillsDir = join8(targetDir, ".claude", "skills");
   const platform = [];
   const community = [];
   if (!await pathExists(skillsDir)) {
@@ -770,11 +907,11 @@ async function listSkills(targetDir) {
     return { platform, community };
   }
   for (const entry of entries.sort()) {
-    const skillFile = join7(skillsDir, entry, "SKILL.md");
+    const skillFile = join8(skillsDir, entry, "SKILL.md");
     if (!await pathExists(skillFile)) continue;
     let content;
     try {
-      content = await readFile4(skillFile, "utf-8");
+      content = await readFile5(skillFile, "utf-8");
     } catch {
       continue;
     }
@@ -822,7 +959,7 @@ async function addSkill(targetDir, source) {
     console.log("  Platform skills (flydocs-*) are managed by the installer.");
     return;
   }
-  const skillsDir = join7(targetDir, ".claude", "skills", skillName);
+  const skillsDir = join8(targetDir, ".claude", "skills", skillName);
   if (await pathExists(skillsDir)) {
     printWarning(`Skill '${skillName}' is already installed.`);
     console.log(`  Remove first: flydocs skills remove ${skillName}`);
@@ -851,13 +988,13 @@ async function addSkill(targetDir, source) {
     printError(`Skill not found at ${repo}/skills/${skillName}`);
     return;
   }
-  const skillMdPath = join7(skillsDir, "SKILL.md");
+  const skillMdPath = join8(skillsDir, "SKILL.md");
   if (!await pathExists(skillMdPath)) {
     await rm2(skillsDir, { recursive: true, force: true });
     printError("Invalid skill: SKILL.md not found.");
     return;
   }
-  const skillMdContent = await readFile4(skillMdPath, "utf-8");
+  const skillMdContent = await readFile5(skillMdPath, "utf-8");
   const fm = parseFrontmatter(skillMdContent);
   if (fm === null || !fm["name"] || !fm["description"]) {
     await rm2(skillsDir, { recursive: true, force: true });
@@ -872,11 +1009,11 @@ async function addSkill(targetDir, source) {
     );
   }
   printStatus("Downloaded skill files");
-  const cursorRuleSrc = join7(skillsDir, "cursor-rule.mdc");
+  const cursorRuleSrc = join8(skillsDir, "cursor-rule.mdc");
   if (await pathExists(cursorRuleSrc)) {
-    const cursorRulesDir = join7(targetDir, ".cursor", "rules");
-    await mkdir2(cursorRulesDir, { recursive: true });
-    const cursorRuleDest = join7(cursorRulesDir, `${skillName}.mdc`);
+    const cursorRulesDir = join8(targetDir, ".cursor", "rules");
+    await mkdir3(cursorRulesDir, { recursive: true });
+    const cursorRuleDest = join8(cursorRulesDir, `${skillName}.mdc`);
     await copyFile(cursorRuleSrc, cursorRuleDest);
     printStatus("Installed cursor rule");
   }
@@ -903,14 +1040,14 @@ async function removeSkill(targetDir, name) {
     console.log("  Platform skills (flydocs-*) are managed by the installer.");
     return;
   }
-  const skillDir = join7(targetDir, ".claude", "skills", name);
+  const skillDir = join8(targetDir, ".claude", "skills", name);
   if (!await pathExists(skillDir)) {
     printError(`Skill '${name}' is not installed.`);
     return;
   }
   await rm2(skillDir, { recursive: true, force: true });
   printStatus("Removed skill directory");
-  const cursorRule = join7(targetDir, ".cursor", "rules", `${name}.mdc`);
+  const cursorRule = join8(targetDir, ".cursor", "rules", `${name}.mdc`);
   if (await pathExists(cursorRule)) {
     await rm2(cursorRule, { force: true });
     printStatus("Removed cursor rule");
@@ -975,7 +1112,7 @@ var init_skill_manager = __esm({
 });
 
 // src/lib/community-skills.ts
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 import { multiselect, isCancel, cancel } from "@clack/prompts";
 import pc4 from "picocolors";
 function suggestSkills(stack) {
@@ -994,10 +1131,10 @@ function suggestSkills(stack) {
 }
 async function promptCommunitySkills(targetDir, stack, autoYes) {
   const suggestions = suggestSkills(stack);
-  const skillsDir = join8(targetDir, ".claude", "skills");
+  const skillsDir = join9(targetDir, ".claude", "skills");
   const filtered = [];
   for (const skill of suggestions) {
-    if (!await pathExists(join8(skillsDir, skill.name))) {
+    if (!await pathExists(join9(skillsDir, skill.name))) {
       filtered.push(skill);
     }
   }
@@ -1154,48 +1291,48 @@ var init_community_skills = __esm({
 });
 
 // src/lib/deprecated.ts
-import { readdir as readdir2, mkdir as mkdir3, rename, rm as rm3 } from "fs/promises";
-import { join as join9 } from "path";
+import { readdir as readdir2, mkdir as mkdir4, rename, rm as rm3 } from "fs/promises";
+import { join as join10 } from "path";
 import { confirm, isCancel as isCancel2 } from "@clack/prompts";
 async function scanDeprecated(targetDir) {
   const found = [];
   for (const item of [...DEPRECATED_DIRS, ...DEPRECATED_FILES]) {
-    if (await pathExists(join9(targetDir, item))) {
+    if (await pathExists(join10(targetDir, item))) {
       found.push(item);
     }
   }
   for (const skill of DEPRECATED_SKILLS) {
-    const p = join9(targetDir, ".claude", "skills", skill);
+    const p = join10(targetDir, ".claude", "skills", skill);
     if (await pathExists(p)) {
       found.push(`.claude/skills/${skill}`);
     }
   }
   for (const dir of DEPRECATED_RULES_DIR) {
-    if (await pathExists(join9(targetDir, dir))) {
+    if (await pathExists(join10(targetDir, dir))) {
       found.push(dir);
     }
   }
   for (const hook of DEPRECATED_HOOKS) {
-    const p = join9(targetDir, ".flydocs", "hooks", hook);
+    const p = join10(targetDir, ".flydocs", "hooks", hook);
     if (await pathExists(p)) {
       found.push(`.flydocs/hooks/${hook}`);
     }
   }
   for (const rule of DEPRECATED_CURSOR_RULES) {
-    const p = join9(targetDir, ".cursor", "rules", rule);
+    const p = join10(targetDir, ".cursor", "rules", rule);
     if (await pathExists(p)) {
       found.push(`.cursor/rules/${rule}`);
     }
   }
   for (const dir of DEPRECATED_CURSOR_RULE_DIRS) {
-    const p = join9(targetDir, ".cursor", "rules", dir);
+    const p = join10(targetDir, ".cursor", "rules", dir);
     if (await pathExists(p)) {
       found.push(`.cursor/rules/${dir}`);
     }
   }
   for (const cmd of DEPRECATED_COMMANDS) {
     for (const prefix of [".cursor/commands", ".claude/commands"]) {
-      const p = join9(targetDir, prefix, cmd);
+      const p = join10(targetDir, prefix, cmd);
       if (await pathExists(p)) {
         found.push(`${prefix}/${cmd}`);
       }
@@ -1204,22 +1341,22 @@ async function scanDeprecated(targetDir) {
   return found;
 }
 async function handleLegacyContext(targetDir) {
-  const contextDir = join9(targetDir, "flydocs", "context");
-  const legacyDir = join9(contextDir, "legacy");
+  const contextDir = join10(targetDir, "flydocs", "context");
+  const legacyDir = join10(contextDir, "legacy");
   const oldFiles = ["overview.md", "stack.md", "standards.md"];
   let hasOld = false;
   for (const f of oldFiles) {
-    if (await pathExists(join9(contextDir, f))) {
+    if (await pathExists(join10(contextDir, f))) {
       hasOld = true;
       break;
     }
   }
   if (hasOld) {
-    await mkdir3(legacyDir, { recursive: true });
+    await mkdir4(legacyDir, { recursive: true });
     for (const f of oldFiles) {
-      const src = join9(contextDir, f);
+      const src = join10(contextDir, f);
       if (await pathExists(src)) {
-        await rename(src, join9(legacyDir, f));
+        await rename(src, join10(legacyDir, f));
         printStatus(`Moved flydocs/context/${f} \u2192 legacy/`);
       }
     }
@@ -1229,7 +1366,7 @@ async function handleLegacyContext(targetDir) {
   }
 }
 async function checkLegacyFolder(targetDir) {
-  const legacyDir = join9(targetDir, "flydocs", "context", "legacy");
+  const legacyDir = join10(targetDir, "flydocs", "context", "legacy");
   if (!await pathExists(legacyDir)) return null;
   try {
     const entries = await readdir2(legacyDir);
@@ -1259,7 +1396,7 @@ async function promptCleanup(targetDir, paths) {
     return;
   }
   for (const p of paths) {
-    await rm3(join9(targetDir, p), { recursive: true, force: true });
+    await rm3(join10(targetDir, p), { recursive: true, force: true });
     printStatus(`Deleted: ${p}`);
   }
 }
@@ -1310,26 +1447,26 @@ var init_deprecated = __esm({
 });
 
 // src/lib/gitignore.ts
-import { readFile as readFile5, writeFile as writeFile3, appendFile } from "fs/promises";
-import { join as join10 } from "path";
+import { readFile as readFile6, writeFile as writeFile4, appendFile } from "fs/promises";
+import { join as join11 } from "path";
 async function ensureGitignore(targetDir) {
-  const gitignorePath = join10(targetDir, ".gitignore");
+  const gitignorePath = join11(targetDir, ".gitignore");
   if (await pathExists(gitignorePath)) {
-    const content = await readFile5(gitignorePath, "utf-8");
+    const content = await readFile6(gitignorePath, "utf-8");
     if (!content.includes("# FlyDocs")) {
       const section = "\n# FlyDocs\n" + FLYDOCS_GITIGNORE_ENTRIES.join("\n") + "\n";
       await appendFile(gitignorePath, section, "utf-8");
       printStatus("Added FlyDocs entries to .gitignore");
     }
   } else {
-    await writeFile3(gitignorePath, FULL_GITIGNORE_TEMPLATE, "utf-8");
+    await writeFile4(gitignorePath, FULL_GITIGNORE_TEMPLATE, "utf-8");
     printStatus(".gitignore (new)");
   }
 }
 async function migrateGitignore(targetDir) {
-  const gitignorePath = join10(targetDir, ".gitignore");
+  const gitignorePath = join11(targetDir, ".gitignore");
   if (!await pathExists(gitignorePath)) return;
-  const content = await readFile5(gitignorePath, "utf-8");
+  const content = await readFile6(gitignorePath, "utf-8");
   if (!content.includes("flydocs/context/graph.json")) {
     if (content.includes("# FlyDocs")) {
       const lines = content.split("\n");
@@ -1340,7 +1477,7 @@ async function migrateGitignore(targetDir) {
           insertIdx++;
         }
         lines.splice(insertIdx, 0, "flydocs/context/graph.json");
-        await writeFile3(gitignorePath, lines.join("\n"), "utf-8");
+        await writeFile4(gitignorePath, lines.join("\n"), "utf-8");
       } else {
         await appendFile(
           gitignorePath,
@@ -1409,7 +1546,7 @@ __pycache__/
 });
 
 // src/lib/version.ts
-import { readFile as readFile6 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 function compareVersions(v1, v2) {
   const [core1, pre1] = v1.split("-", 2);
   const [core2, pre2] = v2.split("-", 2);
@@ -1448,7 +1585,7 @@ function compareVersions(v1, v2) {
 async function getWhatsNew(changelogPath, fromVersion, toVersion) {
   let content;
   try {
-    content = await readFile6(changelogPath, "utf-8");
+    content = await readFile7(changelogPath, "utf-8");
   } catch {
     return [];
   }
@@ -1477,13 +1614,13 @@ var init_version = __esm({
 });
 
 // src/lib/update-check.ts
-import { readFile as readFile7, writeFile as writeFile4, mkdir as mkdir4 } from "fs/promises";
-import { join as join11 } from "path";
+import { readFile as readFile8, writeFile as writeFile5, mkdir as mkdir5 } from "fs/promises";
+import { join as join12 } from "path";
 import { homedir } from "os";
 import pc5 from "picocolors";
 async function readCache() {
   try {
-    const raw = await readFile7(CACHE_FILE, "utf-8");
+    const raw = await readFile8(CACHE_FILE, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && "checkedAt" in parsed && "latestVersion" in parsed && typeof parsed.checkedAt === "number" && typeof parsed.latestVersion === "string") {
       return parsed;
@@ -1495,8 +1632,8 @@ async function readCache() {
 }
 async function writeCache(cache) {
   try {
-    await mkdir4(join11(homedir(), ".flydocs"), { recursive: true });
-    await writeFile4(CACHE_FILE, JSON.stringify(cache), "utf-8");
+    await mkdir5(join12(homedir(), ".flydocs"), { recursive: true });
+    await writeFile5(CACHE_FILE, JSON.stringify(cache), "utf-8");
   } catch {
   }
 }
@@ -1564,12 +1701,145 @@ var init_update_check = __esm({
     "use strict";
     init_constants();
     init_version();
-    CACHE_FILE = join11(homedir(), ".flydocs", "update-check.json");
+    CACHE_FILE = join12(homedir(), ".flydocs", "update-check.json");
     CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
     FETCH_TIMEOUT_MS = 5e3;
   }
 });
 
+// src/lib/telemetry.ts
+import { readFile as readFile9, writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
+import { randomUUID } from "crypto";
+import { join as join13 } from "path";
+import { homedir as homedir2 } from "os";
+async function readConfig2() {
+  try {
+    const raw = await readFile9(CONFIG_FILE, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "object" && parsed !== null && "enabled" in parsed && "anonymousId" in parsed && typeof parsed.enabled === "boolean" && typeof parsed.anonymousId === "string") {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+async function writeConfig2(config) {
+  try {
+    await mkdir6(CONFIG_DIR, { recursive: true });
+    await writeFile6(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+  } catch {
+  }
+}
+async function ensureConfig() {
+  const existing = await readConfig2();
+  if (existing) {
+    return existing;
+  }
+  const config = {
+    enabled: false,
+    anonymousId: randomUUID()
+  };
+  await writeConfig2(config);
+  return config;
+}
+async function isEnabled() {
+  try {
+    if (process.env.FLYDOCS_TELEMETRY === "0") {
+      return false;
+    }
+    const config = await readConfig2();
+    if (config) {
+      return config.enabled;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function baseProperties() {
+  return {
+    cli_version: CLI_VERSION,
+    os: process.platform,
+    os_arch: process.arch,
+    node_version: process.version,
+    is_ci: Boolean(
+      process.env.CI || process.env.CONTINUOUS_INTEGRATION || process.env.BUILD_NUMBER
+    ),
+    $ip: null,
+    $process_person_profile: false
+  };
+}
+async function capture(event, properties = {}) {
+  try {
+    if (!await isEnabled()) {
+      return;
+    }
+    const config = await ensureConfig();
+    eventQueue.push({
+      event,
+      properties: {
+        distinct_id: config.anonymousId,
+        ...baseProperties(),
+        ...properties
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  } catch {
+  }
+}
+async function flush() {
+  try {
+    if (eventQueue.length === 0) {
+      return;
+    }
+    if (!await isEnabled()) {
+      eventQueue.length = 0;
+      return;
+    }
+    const batch = eventQueue.splice(0, eventQueue.length);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
+    await fetch(POSTHOG_BATCH_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        api_key: POSTHOG_API_KEY,
+        batch
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+  } catch {
+  }
+}
+async function setEnabled(enabled) {
+  const config = await ensureConfig();
+  config.enabled = enabled;
+  await writeConfig2(config);
+}
+async function getStatus() {
+  const envOverride = process.env.FLYDOCS_TELEMETRY === "0";
+  const config = await readConfig2();
+  return {
+    enabled: config?.enabled ?? false,
+    envOverride,
+    anonymousId: config?.anonymousId ?? null
+  };
+}
+var CONFIG_DIR, CONFIG_FILE, POSTHOG_BATCH_URL, FETCH_TIMEOUT_MS2, eventQueue;
+var init_telemetry = __esm({
+  "src/lib/telemetry.ts"() {
+    "use strict";
+    init_constants();
+    CONFIG_DIR = join13(homedir2(), ".flydocs");
+    CONFIG_FILE = join13(CONFIG_DIR, "telemetry.json");
+    POSTHOG_BATCH_URL = "https://us.i.posthog.com/batch/";
+    FETCH_TIMEOUT_MS2 = 5e3;
+    eventQueue = [];
+  }
+});
+
 // src/commands/install.ts
 var install_exports = {};
 __export(install_exports, {
@@ -1577,8 +1847,10 @@ __export(install_exports, {
 });
 import { defineCommand } from "citty";
 import { resolve as resolve2 } from "path";
-import { join as join12 } from "path";
+import { join as join14 } from "path";
+import { mkdir as mkdir7 } from "fs/promises";
 import { confirm as confirm2, select, isCancel as isCancel3, cancel as cancel2 } from "@clack/prompts";
+import pc6 from "picocolors";
 var install_default;
 var init_install = __esm({
   "src/commands/install.ts"() {
@@ -1588,12 +1860,14 @@ var init_install = __esm({
     init_ui();
     init_config();
     init_skills();
+    init_user_content();
     init_stack();
     init_community_skills();
     init_deprecated();
     init_gitignore();
     init_post_install();
     init_update_check();
+    init_telemetry();
     install_default = defineCommand({
       meta: {
         name: "install",
@@ -1602,7 +1876,7 @@ var init_install = __esm({
       args: {
         tier: {
           type: "string",
-          description: "Set tier: 'local' (free) or 'cloud' (Linear)"
+          description: "Set tier: 'local' (free) or 'cloud' (managed)"
         },
         path: {
           type: "string",
@@ -1629,6 +1903,7 @@ var init_install = __esm({
         const templateDir = await resolveTemplatePath(args["local-source"]);
         const version = await readTemplateVersion(templateDir);
         printBanner(version);
+        await capture("install_started", { template_version: version });
         let targetDir;
         if (args.path) {
           targetDir = resolve2(args.path.replace(/^~/, process.env.HOME ?? "~"));
@@ -1654,60 +1929,95 @@ var init_install = __esm({
             process.exit(1);
           }
           tier = args.tier;
-          printInfo(`Tier set via flag: ${tier}`);
-        } else if (await pathExists(join12(targetDir, ".flydocs", "config.json"))) {
+        } else if (await pathExists(join14(targetDir, ".flydocs", "config.json"))) {
           try {
             const existing = await readConfig(targetDir);
             if (existing.tier) {
               tier = existing.tier;
-              printInfo(`Tier from config: ${tier}`);
             }
           } catch {
           }
         }
-        if (!tier) {
-          const shouldInstall = await confirm2({
-            message: `Install FlyDocs here? (local tier)
+        if (!args.tier) {
+          if (!tier) {
+            const tierChoice = await select({
+              message: `Install FlyDocs in: ${targetDir}`,
+              options: [
+                {
+                  value: "local",
+                  label: "Local (free)",
+                  hint: "File-based issues, no account needed"
+                },
+                {
+                  value: "cloud",
+                  label: "Cloud (managed)",
+                  hint: "Sync with Linear \u2014 run flydocs connect after install"
+                }
+              ]
+            });
+            if (isCancel3(tierChoice)) {
+              cancel2("Installation cancelled.");
+              process.exit(0);
+            }
+            tier = tierChoice;
+            console.log();
+          } else {
+            const shouldInstall = await confirm2({
+              message: `Install FlyDocs here? (${tier} tier)
   Directory: ${targetDir}`
-          });
-          if (isCancel3(shouldInstall) || !shouldInstall) {
-            cancel2("Installation cancelled.");
-            process.exit(0);
+            });
+            if (isCancel3(shouldInstall) || !shouldInstall) {
+              cancel2("Installation cancelled.");
+              process.exit(0);
+            }
+            console.log();
           }
+        }
+        if (!tier) {
           tier = "local";
-          console.log();
         }
-        if (!await pathExists(join12(targetDir, ".git"))) {
+        printInfo(`Tier: ${tier}`);
+        await capture("install_tier_selected", { tier });
+        if (!await pathExists(join14(targetDir, ".git"))) {
           printWarning("No git repository detected. Run git init when ready.");
         }
         await ensureDirectories(targetDir, tier);
+        const backedUp = await backupOriginals(targetDir);
+        if (backedUp.length > 0) {
+          printStatus(
+            `Backed up ${backedUp.length} existing config file(s) to .flydocs/backup-originals/`
+          );
+          for (const f of backedUp) {
+            printInfo(`  ${f}`);
+          }
+        }
         console.log("Installing framework files...");
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "templates"),
-          join12(targetDir, ".flydocs", "templates")
+          join14(templateDir, ".flydocs", "templates"),
+          join14(targetDir, ".flydocs", "templates")
         );
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "hooks"),
-          join12(targetDir, ".flydocs", "hooks")
+          join14(templateDir, ".flydocs", "hooks"),
+          join14(targetDir, ".flydocs", "hooks")
         );
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "scripts"),
-          join12(targetDir, ".flydocs", "scripts")
+          join14(templateDir, ".flydocs", "scripts"),
+          join14(targetDir, ".flydocs", "scripts")
         );
         await copyFile(
-          join12(templateDir, ".flydocs", "version"),
-          join12(targetDir, ".flydocs", "version")
+          join14(templateDir, ".flydocs", "version"),
+          join14(targetDir, ".flydocs", "version")
         );
-        const manifestSrc = join12(templateDir, "manifest.json");
+        const manifestSrc = join14(templateDir, "manifest.json");
         if (await pathExists(manifestSrc)) {
-          await copyFile(manifestSrc, join12(targetDir, ".flydocs", "manifest.json"));
+          await copyFile(manifestSrc, join14(targetDir, ".flydocs", "manifest.json"));
         }
-        const changelogSrc = join12(templateDir, "CHANGELOG.md");
+        const changelogSrc = join14(templateDir, "CHANGELOG.md");
         if (await pathExists(changelogSrc)) {
-          await copyFile(changelogSrc, join12(targetDir, ".flydocs", "CHANGELOG.md"));
+          await copyFile(changelogSrc, join14(targetDir, ".flydocs", "CHANGELOG.md"));
         }
         printStatus(".flydocs/templates, hooks, version, manifest, changelog");
-        const configPath = join12(targetDir, ".flydocs", "config.json");
+        const configPath = join14(targetDir, ".flydocs", "config.json");
         if (!await pathExists(configPath)) {
           const config = await createFreshConfig(templateDir, version, tier);
           await writeConfig(targetDir, config);
@@ -1732,48 +2042,84 @@ var init_install = __esm({
         await installOwnedSkills(templateDir, targetDir, tier);
         printStatus(`Skills installed (tier: ${tier})`);
         console.log();
-        console.log("Installing agents and commands...");
-        const claudeAgentsSrc = join12(templateDir, ".claude", "agents");
-        if (await pathExists(claudeAgentsSrc)) {
-          await copyDirectoryContents(
-            claudeAgentsSrc,
-            join12(targetDir, ".claude", "agents")
-          );
+        console.log(`  ${pc6.bold(pc6.yellow("Sub-Agents (Recommended)"))}`);
+        console.log();
+        console.log(
+          "  Sub-agents are specialized roles (PM, implementation, review,"
+        );
+        console.log(
+          "  research) that your AI tool can delegate tasks to. They help"
+        );
+        console.log(
+          "  structure work but are not required \u2014 everything works without them."
+        );
+        console.log();
+        let installAgents;
+        if (args.yes) {
+          installAgents = true;
+          console.log("  Auto-accepting (--yes)");
+        } else {
+          const agentConfirm = await confirm2({
+            message: "Install sub-agents?",
+            initialValue: true
+          });
+          if (isCancel3(agentConfirm)) {
+            installAgents = false;
+          } else {
+            installAgents = agentConfirm;
+          }
         }
+        await capture("install_agents_chosen", { install_agents: installAgents });
+        if (installAgents) {
+          const claudeAgentsSrc = join14(templateDir, ".claude", "agents");
+          if (await pathExists(claudeAgentsSrc)) {
+            await mkdir7(join14(targetDir, ".claude", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              claudeAgentsSrc,
+              join14(targetDir, ".claude", "agents")
+            );
+          }
+          const cursorAgentsSrc = join14(templateDir, ".cursor", "agents");
+          if (await pathExists(cursorAgentsSrc)) {
+            await mkdir7(join14(targetDir, ".cursor", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              cursorAgentsSrc,
+              join14(targetDir, ".cursor", "agents")
+            );
+          }
+          printStatus("Sub-agents installed (.claude/agents, .cursor/agents)");
+        } else {
+          printInfo("Skipped sub-agents");
+        }
+        console.log();
+        console.log("Installing commands and settings...");
         await copyDirectoryContents(
-          join12(templateDir, ".claude", "commands"),
-          join12(targetDir, ".claude", "commands")
+          join14(templateDir, ".claude", "commands"),
+          join14(targetDir, ".claude", "commands")
         );
         await copyFile(
-          join12(templateDir, ".claude", "CLAUDE.md"),
-          join12(targetDir, ".claude", "CLAUDE.md")
+          join14(templateDir, ".claude", "CLAUDE.md"),
+          join14(targetDir, ".claude", "CLAUDE.md")
         );
         await copyFile(
-          join12(templateDir, ".claude", "settings.json"),
-          join12(targetDir, ".claude", "settings.json")
+          join14(templateDir, ".claude", "settings.json"),
+          join14(targetDir, ".claude", "settings.json")
         );
-        printStatus(".claude/ (agents, commands, CLAUDE.md, settings)");
-        const cursorAgentsSrc = join12(templateDir, ".cursor", "agents");
-        if (await pathExists(cursorAgentsSrc)) {
-          await copyDirectoryContents(
-            cursorAgentsSrc,
-            join12(targetDir, ".cursor", "agents")
-          );
-        }
+        printStatus(".claude/ (commands, CLAUDE.md, settings)");
         await copyDirectoryContents(
-          join12(templateDir, ".claude", "commands"),
-          join12(targetDir, ".cursor", "commands")
+          join14(templateDir, ".claude", "commands"),
+          join14(targetDir, ".cursor", "commands")
         );
         await copyFile(
-          join12(templateDir, ".cursor", "hooks.json"),
-          join12(targetDir, ".cursor", "hooks.json")
+          join14(templateDir, ".cursor", "hooks.json"),
+          join14(targetDir, ".cursor", "hooks.json")
         );
-        printStatus(".cursor/ (agents, commands, hooks)");
+        printStatus(".cursor/ (commands, hooks)");
         await copyCursorRules(targetDir);
         printStatus(".cursor/rules/");
         await copyFile(
-          join12(templateDir, "AGENTS.md"),
-          join12(targetDir, "AGENTS.md")
+          join14(templateDir, "AGENTS.md"),
+          join14(targetDir, "AGENTS.md")
         );
         printStatus("AGENTS.md");
         await runManifestGeneration(targetDir);
@@ -1782,40 +2128,40 @@ var init_install = __esm({
         console.log("Installing project templates...");
         const userFiles = [
           {
-            src: join12(templateDir, "flydocs", "context", "project.md"),
-            dest: join12(targetDir, "flydocs", "context", "project.md"),
+            src: join14(templateDir, "flydocs", "context", "project.md"),
+            dest: join14(targetDir, "flydocs", "context", "project.md"),
             label: "flydocs/context/project.md"
           },
           {
-            src: join12(templateDir, "flydocs", "knowledge", "INDEX.md"),
-            dest: join12(targetDir, "flydocs", "knowledge", "INDEX.md"),
+            src: join14(templateDir, "flydocs", "knowledge", "INDEX.md"),
+            dest: join14(targetDir, "flydocs", "knowledge", "INDEX.md"),
             label: "flydocs/knowledge/INDEX.md"
           },
           {
-            src: join12(templateDir, "flydocs", "knowledge", "README.md"),
-            dest: join12(targetDir, "flydocs", "knowledge", "README.md"),
+            src: join14(templateDir, "flydocs", "knowledge", "README.md"),
+            dest: join14(targetDir, "flydocs", "knowledge", "README.md"),
             label: "flydocs/knowledge/README.md"
           },
           {
-            src: join12(
+            src: join14(
               templateDir,
               "flydocs",
               "knowledge",
               "product",
               "personas.md"
             ),
-            dest: join12(targetDir, "flydocs", "knowledge", "product", "personas.md"),
+            dest: join14(targetDir, "flydocs", "knowledge", "product", "personas.md"),
             label: "flydocs/knowledge/product/personas.md"
           },
           {
-            src: join12(
+            src: join14(
               templateDir,
               "flydocs",
               "knowledge",
               "product",
               "user-flows.md"
             ),
-            dest: join12(
+            dest: join14(
               targetDir,
               "flydocs",
               "knowledge",
@@ -1825,18 +2171,18 @@ var init_install = __esm({
             label: "flydocs/knowledge/product/user-flows.md"
           },
           {
-            src: join12(templateDir, "flydocs", "design-system", "README.md"),
-            dest: join12(targetDir, "flydocs", "design-system", "README.md"),
+            src: join14(templateDir, "flydocs", "design-system", "README.md"),
+            dest: join14(targetDir, "flydocs", "design-system", "README.md"),
             label: "flydocs/design-system/README.md"
           },
           {
-            src: join12(
+            src: join14(
               templateDir,
               "flydocs",
               "design-system",
               "component-patterns.md"
             ),
-            dest: join12(
+            dest: join14(
               targetDir,
               "flydocs",
               "design-system",
@@ -1845,13 +2191,13 @@ var init_install = __esm({
             label: "flydocs/design-system/component-patterns.md"
           },
           {
-            src: join12(templateDir, "flydocs", "design-system", "token-mapping.md"),
-            dest: join12(targetDir, "flydocs", "design-system", "token-mapping.md"),
+            src: join14(templateDir, "flydocs", "design-system", "token-mapping.md"),
+            dest: join14(targetDir, "flydocs", "design-system", "token-mapping.md"),
             label: "flydocs/design-system/token-mapping.md"
           },
           {
-            src: join12(templateDir, "flydocs", "README.md"),
-            dest: join12(targetDir, "flydocs", "README.md"),
+            src: join14(templateDir, "flydocs", "README.md"),
+            dest: join14(targetDir, "flydocs", "README.md"),
             label: "flydocs/README.md"
           }
         ];
@@ -1865,14 +2211,10 @@ var init_install = __esm({
             }
           }
         }
-        const envExampleSrc = join12(templateDir, ".env.example");
+        const envExampleSrc = join14(templateDir, ".env.example");
         if (await pathExists(envExampleSrc)) {
-          const hasEnv = await pathExists(join12(targetDir, ".env"));
-          const hasEnvExample = await pathExists(join12(targetDir, ".env.example"));
-          if (!hasEnv && !hasEnvExample) {
-            await copyFile(envExampleSrc, join12(targetDir, ".env.example"));
-            printStatus(".env.example (new)");
-          }
+          await copyFile(envExampleSrc, join14(targetDir, ".env.example"));
+          printStatus(".env.example");
         }
         await ensureGitignore(targetDir);
         console.log();
@@ -1890,6 +2232,9 @@ var init_install = __esm({
         } else {
           printInfo("No framework detected in package.json");
         }
+        await capture("install_skills_chosen", {
+          stack_detected: stack.raw
+        });
         console.log();
         console.log("Checking for deprecated files...");
         const deprecated = await scanDeprecated(targetDir);
@@ -1902,17 +2247,17 @@ var init_install = __esm({
           "  1. Run /flydocs-setup to configure your project",
           "  2. Start working with /start-session",
           "",
-          "Documentation: flydocs/README.md"
+          "Docs: https://www.flydocs.ai/docs"
         ] : [
           `Tier: ${tier}`,
           `Version: ${version}`,
           "",
           "Next steps:",
-          "  1. Copy your LINEAR_API_KEY to .env",
-          "  2. Run /flydocs-setup to configure your Linear workspace",
+          "  1. Run flydocs connect to set up your API key",
+          "  2. Run /flydocs-setup to configure your workspace",
           "  3. Start working with /start-session",
           "",
-          "Documentation: flydocs/README.md"
+          "Docs: https://www.flydocs.ai/docs"
         ];
         let copiedToClipboard = false;
         try {
@@ -1931,6 +2276,7 @@ var init_install = __esm({
         }
         printCompletionBox("Installation Complete!", nextSteps);
         printBetaCta();
+        const detectedIdes = [];
         try {
           const { execSync: execSync2, spawn } = await import("child_process");
           const isInstalled = (cmd) => {
@@ -1966,6 +2312,7 @@ var init_install = __esm({
               passCommand: false
             });
           }
+          detectedIdes.push(...ideOptions.map((o) => o.cmd));
           if (ideOptions.length === 1) {
             const ide = ideOptions[0];
             const launchConfirm = await confirm2({
@@ -2024,6 +2371,9 @@ var init_install = __esm({
           }
         } catch {
         }
+        await capture("install_ide_detected", { ides: detectedIdes });
+        await capture("install_completed", { tier, version });
+        await flush();
         try {
           const updateResult = await checkForUpdate();
           if (updateResult) {
@@ -2042,10 +2392,10 @@ __export(update_exports, {
   default: () => update_default
 });
 import { defineCommand as defineCommand2 } from "citty";
-import { resolve as resolve3, join as join13 } from "path";
-import { mkdir as mkdir5, cp as cp2, readFile as readFile8, readdir as readdir3, rm as rm4 } from "fs/promises";
+import { resolve as resolve3, join as join15 } from "path";
+import { mkdir as mkdir8, cp as cp2, readFile as readFile10, readdir as readdir3, rm as rm4 } from "fs/promises";
 import { select as select2, text, confirm as confirm3, isCancel as isCancel4, cancel as cancel3 } from "@clack/prompts";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 var update_default;
 var init_update = __esm({
   "src/commands/update.ts"() {
@@ -2062,6 +2412,7 @@ var init_update = __esm({
     init_gitignore();
     init_post_install();
     init_update_check();
+    init_telemetry();
     update_default = defineCommand2({
       meta: {
         name: "update",
@@ -2079,7 +2430,7 @@ var init_update = __esm({
         },
         tier: {
           type: "string",
-          description: "Change tier: 'local' (free) or 'cloud' (Linear)"
+          description: "Change tier: 'local' (free) or 'cloud' (managed)"
         },
         force: {
           type: "boolean",
@@ -2104,6 +2455,7 @@ var init_update = __esm({
         printBanner(version);
         printInfo("Running in update mode \u2014 framework files will be refreshed");
         console.log();
+        await capture("update_started", { template_version: version });
         let targetDir;
         if (args.path) {
           targetDir = resolve3(args.path.replace(/^~/, process.env.HOME ?? "~"));
@@ -2148,9 +2500,9 @@ var init_update = __esm({
         }
         targetDir = resolve3(targetDir);
         process.chdir(targetDir);
-        const hasVersion = await pathExists(join13(targetDir, ".flydocs", "version"));
+        const hasVersion = await pathExists(join15(targetDir, ".flydocs", "version"));
         const hasConfig = await pathExists(
-          join13(targetDir, ".flydocs", "config.json")
+          join15(targetDir, ".flydocs", "config.json")
         );
         if (!hasVersion && !hasConfig) {
           printError(`Not a FlyDocs project: ${targetDir}`);
@@ -2161,8 +2513,8 @@ var init_update = __esm({
         console.log();
         let currentVersion = "0.1.0";
         if (hasVersion) {
-          const vContent = await readFile8(
-            join13(targetDir, ".flydocs", "version"),
+          const vContent = await readFile10(
+            join15(targetDir, ".flydocs", "version"),
             "utf-8"
           );
           currentVersion = vContent.trim();
@@ -2188,12 +2540,18 @@ var init_update = __esm({
             process.exit(0);
           }
         }
+        await capture("update_version_compared", {
+          current_version: currentVersion,
+          target_version: version,
+          version_status: versionStatus,
+          force: args.force
+        });
         console.log(`Updating: v${currentVersion} \u2192 v${version}`);
         console.log();
-        const changelogPath = join13(templateDir, "CHANGELOG.md");
+        const changelogPath = join15(templateDir, "CHANGELOG.md");
         const whatsNew = await getWhatsNew(changelogPath, currentVersion, version);
         if (whatsNew.length > 0) {
-          console.log(pc6.cyan("What's new:"));
+          console.log(pc7.cyan("What's new:"));
           console.log();
           for (const entry of whatsNew) {
             console.log(`  ${entry}`);
@@ -2202,23 +2560,23 @@ var init_update = __esm({
         }
         const now = /* @__PURE__ */ new Date();
         const ts = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}-${String(now.getHours()).padStart(2, "0")}${String(now.getMinutes()).padStart(2, "0")}${String(now.getSeconds()).padStart(2, "0")}`;
-        const backupDir = join13(targetDir, ".flydocs", `backup-${ts}`);
-        await mkdir5(backupDir, { recursive: true });
+        const backupDir = join15(targetDir, ".flydocs", `backup-${ts}`);
+        await mkdir8(backupDir, { recursive: true });
         if (hasConfig) {
           await cp2(
-            join13(targetDir, ".flydocs", "config.json"),
-            join13(backupDir, "config.json")
+            join15(targetDir, ".flydocs", "config.json"),
+            join15(backupDir, "config.json")
           );
           printStatus(`Config backed up to .flydocs/backup-${ts}/`);
         }
         try {
-          const flydocsDir = join13(targetDir, ".flydocs");
+          const flydocsDir = join15(targetDir, ".flydocs");
           const entries = await readdir3(flydocsDir);
           const backups = entries.filter((e) => e.startsWith("backup-")).sort();
           if (backups.length > 3) {
             const toRemove = backups.slice(0, backups.length - 3);
             for (const old of toRemove) {
-              await rm4(join13(flydocsDir, old), { recursive: true, force: true });
+              await rm4(join15(flydocsDir, old), { recursive: true, force: true });
             }
           }
         } catch {
@@ -2255,74 +2613,118 @@ var init_update = __esm({
         }
         console.log("Replacing framework directories...");
         await replaceDirectory(
-          join13(templateDir, ".flydocs", "templates"),
-          join13(targetDir, ".flydocs", "templates")
+          join15(templateDir, ".flydocs", "templates"),
+          join15(targetDir, ".flydocs", "templates")
         );
         await replaceDirectory(
-          join13(templateDir, ".flydocs", "hooks"),
-          join13(targetDir, ".flydocs", "hooks")
+          join15(templateDir, ".flydocs", "hooks"),
+          join15(targetDir, ".flydocs", "hooks")
         );
         await replaceDirectory(
-          join13(templateDir, ".flydocs", "scripts"),
-          join13(targetDir, ".flydocs", "scripts")
+          join15(templateDir, ".flydocs", "scripts"),
+          join15(targetDir, ".flydocs", "scripts")
         );
         printStatus(".flydocs/templates, hooks, scripts");
-        const claudeAgentsSrc = join13(templateDir, ".claude", "agents");
-        if (await pathExists(claudeAgentsSrc)) {
-          await copyDirectoryContents(
-            claudeAgentsSrc,
-            join13(targetDir, ".claude", "agents")
+        const hasExistingAgents = await pathExists(
+          join15(targetDir, ".claude", "agents")
+        );
+        let installAgents;
+        if (args.yes) {
+          installAgents = hasExistingAgents ? true : true;
+        } else if (hasExistingAgents) {
+          installAgents = true;
+        } else {
+          console.log();
+          console.log(`  ${pc7.bold(pc7.yellow("Sub-Agents (Recommended)"))}`);
+          console.log();
+          console.log(
+            "  Sub-agents are specialized roles (PM, implementation, review,"
+          );
+          console.log(
+            "  research) that your AI tool can delegate tasks to. They help"
           );
+          console.log(
+            "  structure work but are not required \u2014 everything works without them."
+          );
+          console.log();
+          const agentConfirm = await confirm3({
+            message: "Install sub-agents?",
+            initialValue: true
+          });
+          if (isCancel4(agentConfirm)) {
+            installAgents = false;
+          } else {
+            installAgents = agentConfirm;
+          }
         }
-        printStatus(".claude/agents");
-        await replaceOwnedSkills(templateDir, targetDir, effectiveTier);
-        printStatus(`.claude/skills (tier: ${effectiveTier})`);
-        const cursorAgentsSrc = join13(templateDir, ".cursor", "agents");
-        if (await pathExists(cursorAgentsSrc)) {
-          await copyDirectoryContents(
-            cursorAgentsSrc,
-            join13(targetDir, ".cursor", "agents")
+        if (installAgents) {
+          const claudeAgentsSrc = join15(templateDir, ".claude", "agents");
+          if (await pathExists(claudeAgentsSrc)) {
+            await mkdir8(join15(targetDir, ".claude", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              claudeAgentsSrc,
+              join15(targetDir, ".claude", "agents")
+            );
+          }
+          const cursorAgentsSrc = join15(templateDir, ".cursor", "agents");
+          if (await pathExists(cursorAgentsSrc)) {
+            await mkdir8(join15(targetDir, ".cursor", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              cursorAgentsSrc,
+              join15(targetDir, ".cursor", "agents")
+            );
+          }
+          printStatus(
+            hasExistingAgents ? "Sub-agents updated (.claude/agents, .cursor/agents)" : "Sub-agents installed (.claude/agents, .cursor/agents)"
           );
+        } else {
+          printInfo("Skipped sub-agents");
         }
-        printStatus(".cursor/agents");
+        await replaceOwnedSkills(templateDir, targetDir, effectiveTier);
+        printStatus(`.claude/skills (tier: ${effectiveTier})`);
         console.log();
         console.log("Replacing framework files...");
         await copyFile(
-          join13(templateDir, ".claude", "CLAUDE.md"),
-          join13(targetDir, ".claude", "CLAUDE.md")
+          join15(templateDir, ".claude", "CLAUDE.md"),
+          join15(targetDir, ".claude", "CLAUDE.md")
         );
         await copyFile(
-          join13(templateDir, ".claude", "settings.json"),
-          join13(targetDir, ".claude", "settings.json")
+          join15(templateDir, ".claude", "settings.json"),
+          join15(targetDir, ".claude", "settings.json")
         );
         printStatus(".claude/CLAUDE.md, settings.json");
         await copyDirectoryContents(
-          join13(templateDir, ".claude", "commands"),
-          join13(targetDir, ".claude", "commands")
+          join15(templateDir, ".claude", "commands"),
+          join15(targetDir, ".claude", "commands")
         );
         await copyDirectoryContents(
-          join13(templateDir, ".claude", "commands"),
-          join13(targetDir, ".cursor", "commands")
+          join15(templateDir, ".claude", "commands"),
+          join15(targetDir, ".cursor", "commands")
         );
         printStatus(".claude/commands, .cursor/commands");
-        const skillsReadmeSrc = join13(templateDir, ".claude", "skills", "README.md");
+        const skillsReadmeSrc = join15(templateDir, ".claude", "skills", "README.md");
         if (await pathExists(skillsReadmeSrc)) {
           await copyFile(
             skillsReadmeSrc,
-            join13(targetDir, ".claude", "skills", "README.md")
+            join15(targetDir, ".claude", "skills", "README.md")
           );
         }
         printStatus(".claude/skills/README.md");
         await copyFile(
-          join13(templateDir, ".cursor", "hooks.json"),
-          join13(targetDir, ".cursor", "hooks.json")
+          join15(templateDir, ".cursor", "hooks.json"),
+          join15(targetDir, ".cursor", "hooks.json")
         );
         printStatus(".cursor/hooks.json");
         await copyFile(
-          join13(templateDir, "AGENTS.md"),
-          join13(targetDir, "AGENTS.md")
+          join15(templateDir, "AGENTS.md"),
+          join15(targetDir, "AGENTS.md")
         );
         printStatus("AGENTS.md");
+        const envExampleSrc = join15(templateDir, ".env.example");
+        if (await pathExists(envExampleSrc)) {
+          await copyFile(envExampleSrc, join15(targetDir, ".env.example"));
+          printStatus(".env.example");
+        }
         await runManifestGeneration(targetDir);
         await runContextGraphBuild(targetDir);
         console.log();
@@ -2345,18 +2747,18 @@ var init_update = __esm({
           printWarning("Config merge failed \u2014 config.json preserved as-is");
         }
         await copyFile(
-          join13(templateDir, ".flydocs", "version"),
-          join13(targetDir, ".flydocs", "version")
+          join15(templateDir, ".flydocs", "version"),
+          join15(targetDir, ".flydocs", "version")
         );
         printStatus(`.flydocs/version \u2192 ${version}`);
-        const clSrc = join13(templateDir, "CHANGELOG.md");
+        const clSrc = join15(templateDir, "CHANGELOG.md");
         if (await pathExists(clSrc)) {
-          await copyFile(clSrc, join13(targetDir, ".flydocs", "CHANGELOG.md"));
+          await copyFile(clSrc, join15(targetDir, ".flydocs", "CHANGELOG.md"));
           printStatus(".flydocs/CHANGELOG.md");
         }
-        const mfSrc = join13(templateDir, "manifest.json");
+        const mfSrc = join15(templateDir, "manifest.json");
         if (await pathExists(mfSrc)) {
-          await copyFile(mfSrc, join13(targetDir, ".flydocs", "manifest.json"));
+          await copyFile(mfSrc, join15(targetDir, ".flydocs", "manifest.json"));
           printStatus(".flydocs/manifest.json");
         }
         console.log();
@@ -2392,6 +2794,12 @@ var init_update = __esm({
           `Backup: .flydocs/backup-${ts}/`
         ]);
         printBetaCta();
+        await capture("update_completed", {
+          current_version: currentVersion,
+          version,
+          tier: effectiveTier
+        });
+        await flush();
         try {
           const updateResult = await checkForUpdate();
           if (updateResult) {
@@ -2404,33 +2812,352 @@ var init_update = __esm({
   }
 });
 
+// src/commands/uninstall.ts
+var uninstall_exports = {};
+__export(uninstall_exports, {
+  default: () => uninstall_default
+});
+import { defineCommand as defineCommand3 } from "citty";
+import { resolve as resolve4, join as join16 } from "path";
+import { readdir as readdir4, rm as rm5, rename as rename2 } from "fs/promises";
+import { confirm as confirm4, select as select3, isCancel as isCancel5, cancel as cancel4 } from "@clack/prompts";
+import pc8 from "picocolors";
+async function removeOwnedSkills(targetDir) {
+  const skillsDir = join16(targetDir, ".claude", "skills");
+  const removed = [];
+  if (!await pathExists(skillsDir)) {
+    return removed;
+  }
+  try {
+    const entries = await readdir4(skillsDir);
+    for (const entry of entries) {
+      if (entry.startsWith(OWNED_SKILL_PREFIX)) {
+        await rm5(join16(skillsDir, entry), { recursive: true, force: true });
+        removed.push(`.claude/skills/${entry}`);
+      }
+    }
+  } catch {
+  }
+  return removed;
+}
+async function removeOwnedCursorRules(targetDir) {
+  const rulesDir = join16(targetDir, ".cursor", "rules");
+  const removed = [];
+  if (!await pathExists(rulesDir)) {
+    return removed;
+  }
+  try {
+    const entries = await readdir4(rulesDir);
+    for (const entry of entries) {
+      if (entry.startsWith(OWNED_RULE_PREFIX) && entry.endsWith(".mdc")) {
+        await rm5(join16(rulesDir, entry), { force: true });
+        removed.push(`.cursor/rules/${entry}`);
+      }
+    }
+  } catch {
+  }
+  return removed;
+}
+async function isEmptyDir(dirPath) {
+  try {
+    const entries = await readdir4(dirPath);
+    return entries.length === 0;
+  } catch {
+    return false;
+  }
+}
+async function cleanupEmptyParents(targetDir, dirs) {
+  const cleaned = [];
+  for (const dir of dirs) {
+    const fullPath = join16(targetDir, dir);
+    if (await pathExists(fullPath) && await isEmptyDir(fullPath)) {
+      await rm5(fullPath, { recursive: true, force: true });
+      cleaned.push(dir);
+    }
+  }
+  return cleaned;
+}
+var ALWAYS_REMOVED, OWNED_SKILL_PREFIX, OWNED_RULE_PREFIX, uninstall_default;
+var init_uninstall = __esm({
+  "src/commands/uninstall.ts"() {
+    "use strict";
+    init_fs_ops();
+    init_user_content();
+    init_ui();
+    init_constants();
+    ALWAYS_REMOVED = [
+      [".claude/CLAUDE.md", "file"],
+      [".claude/settings.json", "file"],
+      [".claude/agents", "dir"],
+      [".claude/commands", "dir"],
+      [".claude/skills/README.md", "file"],
+      [".cursor/hooks.json", "file"],
+      [".cursor/agents", "dir"],
+      [".flydocs", "dir"],
+      ["AGENTS.md", "file"],
+      [".env.example", "file"]
+    ];
+    OWNED_SKILL_PREFIX = "flydocs-";
+    OWNED_RULE_PREFIX = "flydocs-";
+    uninstall_default = defineCommand3({
+      meta: {
+        name: "uninstall",
+        description: "Remove FlyDocs from a project directory"
+      },
+      args: {
+        path: {
+          type: "string",
+          description: "Uninstall from the specified directory"
+        },
+        here: {
+          type: "boolean",
+          description: "Uninstall from the current directory",
+          default: false
+        },
+        all: {
+          type: "boolean",
+          description: "Remove everything including flydocs/ user content",
+          default: false
+        },
+        yes: {
+          type: "boolean",
+          alias: ["y"],
+          description: "Skip confirmation prompts",
+          default: false
+        },
+        force: {
+          type: "boolean",
+          description: "Alias for --all --yes (complete removal, no prompts)",
+          default: false
+        }
+      },
+      async run({ args }) {
+        printBanner(CLI_VERSION);
+        let targetDir;
+        if (args.path) {
+          targetDir = resolve4(args.path.replace(/^~/, process.env.HOME ?? "~"));
+        } else if (args.here) {
+          targetDir = process.cwd();
+        } else {
+          targetDir = process.cwd();
+        }
+        if (!await pathExists(targetDir)) {
+          printError(`Directory does not exist: ${targetDir}`);
+          process.exit(1);
+        }
+        targetDir = resolve4(targetDir);
+        const hasFlydocs = await pathExists(join16(targetDir, ".flydocs"));
+        const hasAgentsMd = await pathExists(join16(targetDir, "AGENTS.md"));
+        if (!hasFlydocs && !hasAgentsMd) {
+          printError(`Not a FlyDocs project: ${targetDir}`);
+          printInfo("No .flydocs/ directory or AGENTS.md found.");
+          process.exit(1);
+        }
+        printInfo(`Project: ${targetDir}`);
+        console.log();
+        const forceAll = args.force;
+        const removeAll = forceAll || args.all;
+        const skipPrompts = forceAll || args.yes;
+        let contentAction = "preserve";
+        const hasUserContent = await pathExists(join16(targetDir, "flydocs"));
+        if (hasUserContent) {
+          if (removeAll) {
+            contentAction = "remove";
+          } else if (!skipPrompts) {
+            const choice = await select3({
+              message: "What should happen to your flydocs/ content (project docs, knowledge base)?",
+              options: [
+                {
+                  value: "archive",
+                  label: "Archive",
+                  hint: "Rename to flydocs-archive/ (safe, reversible)"
+                },
+                {
+                  value: "remove",
+                  label: "Remove completely",
+                  hint: "Permanently delete flydocs/ and all contents"
+                },
+                {
+                  value: "preserve",
+                  label: "Keep as-is",
+                  hint: "Leave flydocs/ untouched"
+                }
+              ]
+            });
+            if (isCancel5(choice)) {
+              cancel4("Uninstall cancelled.");
+              process.exit(0);
+            }
+            contentAction = choice;
+          }
+        }
+        if (!skipPrompts) {
+          console.log();
+          console.log(pc8.bold("The following will be removed:"));
+          console.log();
+          console.log("  Framework files:");
+          for (const [path] of ALWAYS_REMOVED) {
+            console.log(`    ${pc8.dim(path)}`);
+          }
+          console.log(`    ${pc8.dim(".claude/skills/flydocs-*")}`);
+          console.log(`    ${pc8.dim(".cursor/rules/flydocs-*.mdc")}`);
+          if (hasUserContent) {
+            if (contentAction === "archive") {
+              console.log();
+              console.log(
+                `  User content: ${pc8.yellow("flydocs/ -> flydocs-archive/")}`
+              );
+            } else if (contentAction === "remove") {
+              console.log();
+              console.log(`  User content: ${pc8.red("flydocs/ (deleted)")}`);
+            } else {
+              console.log();
+              console.log(`  User content: ${pc8.green("flydocs/ (preserved)")}`);
+            }
+          }
+          console.log();
+          console.log(pc8.bold("Preserved:"));
+          console.log(
+            `    ${pc8.dim(".claude/skills/ (non-flydocs community skills)")}`
+          );
+          console.log(`    ${pc8.dim(".env, .env.local")}`);
+          console.log();
+          const shouldContinue = await confirm4({
+            message: "Proceed with uninstall?"
+          });
+          if (isCancel5(shouldContinue) || !shouldContinue) {
+            cancel4("Uninstall cancelled.");
+            process.exit(0);
+          }
+        }
+        const originals = await readBackupOriginals(targetDir);
+        const result = {
+          removed: [],
+          skipped: [],
+          archived: [],
+          restored: []
+        };
+        const removedSkills = await removeOwnedSkills(targetDir);
+        result.removed.push(...removedSkills);
+        const removedRules = await removeOwnedCursorRules(targetDir);
+        result.removed.push(...removedRules);
+        for (const [relativePath, type] of ALWAYS_REMOVED) {
+          const fullPath = join16(targetDir, relativePath);
+          if (!await pathExists(fullPath)) {
+            result.skipped.push(relativePath);
+            continue;
+          }
+          try {
+            if (type === "dir") {
+              await rm5(fullPath, { recursive: true, force: true });
+            } else {
+              await rm5(fullPath, { force: true });
+            }
+            result.removed.push(relativePath);
+          } catch {
+            printWarning(`Could not remove: ${relativePath}`);
+            result.skipped.push(relativePath);
+          }
+        }
+        if (hasUserContent) {
+          const flydocsPath = join16(targetDir, "flydocs");
+          if (contentAction === "archive") {
+            const archivePath = join16(targetDir, "flydocs-archive");
+            if (await pathExists(archivePath)) {
+              await rm5(archivePath, { recursive: true, force: true });
+            }
+            await rename2(flydocsPath, archivePath);
+            result.archived.push("flydocs/ -> flydocs-archive/");
+          } else if (contentAction === "remove") {
+            await rm5(flydocsPath, { recursive: true, force: true });
+            result.removed.push("flydocs/");
+          }
+        }
+        const emptyCandidates = [
+          ".claude/skills",
+          ".claude",
+          ".cursor/rules",
+          ".cursor"
+        ];
+        const cleaned = await cleanupEmptyParents(targetDir, emptyCandidates);
+        for (const dir of cleaned) {
+          result.removed.push(`${dir}/ (empty, cleaned up)`);
+        }
+        if (originals.length > 0) {
+          await writeRestoredFiles(targetDir, originals);
+          result.restored = originals.map((f) => f.relativePath);
+        }
+        console.log();
+        console.log(pc8.bold("Uninstall Summary"));
+        console.log();
+        if (result.removed.length > 0) {
+          console.log(`  ${pc8.green("Removed")} (${result.removed.length}):`);
+          for (const item of result.removed) {
+            printStatus(item);
+          }
+        }
+        if (result.archived.length > 0) {
+          console.log();
+          console.log(`  ${pc8.yellow("Archived")} (${result.archived.length}):`);
+          for (const item of result.archived) {
+            printInfo(item);
+          }
+        }
+        if (result.restored.length > 0) {
+          console.log();
+          console.log(
+            `  ${pc8.green("Restored")} (${result.restored.length} pre-FlyDocs original(s)):`
+          );
+          for (const item of result.restored) {
+            printInfo(item);
+          }
+        }
+        if (result.skipped.length > 0) {
+          console.log();
+          console.log(
+            `  ${pc8.dim("Skipped")} (${result.skipped.length} \u2014 not found):`
+          );
+          for (const item of result.skipped) {
+            console.log(`  ${pc8.dim(item)}`);
+          }
+        }
+        console.log();
+        printStatus("FlyDocs has been removed from this project.");
+        console.log();
+        printInfo(`To reinstall: ${pc8.cyan("npx @flydocs/cli install --here")}`);
+        console.log();
+      }
+    });
+  }
+});
+
 // src/commands/setup.ts
 var setup_exports = {};
 __export(setup_exports, {
   default: () => setup_default
 });
-import { defineCommand as defineCommand3 } from "citty";
-import pc7 from "picocolors";
+import { defineCommand as defineCommand4 } from "citty";
+import pc9 from "picocolors";
 var setup_default;
 var init_setup = __esm({
   "src/commands/setup.ts"() {
     "use strict";
-    setup_default = defineCommand3({
+    setup_default = defineCommand4({
       meta: {
         name: "setup",
         description: "Configure FlyDocs settings for this project"
       },
       run() {
         console.log();
-        console.log(`  ${pc7.bold("FlyDocs Setup")}`);
+        console.log(`  ${pc9.bold("FlyDocs Setup")}`);
         console.log();
         console.log(`  Setup runs inside your IDE as an interactive AI command.`);
         console.log();
         console.log(
-          `  ${pc7.cyan("Claude Code:")}  Type ${pc7.bold("/flydocs-setup")} in chat`
+          `  ${pc9.cyan("Claude Code:")}  Type ${pc9.bold("/flydocs-setup")} in chat`
         );
         console.log(
-          `  ${pc7.cyan("Cursor:")}      Type ${pc7.bold("/flydocs-setup")} in chat`
+          `  ${pc9.cyan("Cursor:")}      Type ${pc9.bold("/flydocs-setup")} in chat`
         );
         console.log();
         console.log(`  This configures your project context, detects your stack,`);
@@ -2446,14 +3173,14 @@ var skills_exports = {};
 __export(skills_exports, {
   default: () => skills_default
 });
-import { defineCommand as defineCommand4 } from "citty";
-import pc8 from "picocolors";
+import { defineCommand as defineCommand5 } from "citty";
+import pc10 from "picocolors";
 var list, search, add, remove, skills_default;
 var init_skills2 = __esm({
   "src/commands/skills.ts"() {
     "use strict";
     init_skill_manager();
-    list = defineCommand4({
+    list = defineCommand5({
       meta: {
         name: "list",
         description: "List installed skills"
@@ -2469,26 +3196,26 @@ var init_skills2 = __esm({
         console.log(`${total} skill(s) installed:`);
         if (result.platform.length > 0) {
           console.log();
-          console.log(pc8.bold("Platform"));
+          console.log(pc10.bold("Platform"));
           for (const skill of result.platform) {
             console.log(
-              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc10.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
         if (result.community.length > 0) {
           console.log();
-          console.log(pc8.bold("Community"));
+          console.log(pc10.bold("Community"));
           for (const skill of result.community) {
             console.log(
-              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc10.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
         console.log();
       }
     });
-    search = defineCommand4({
+    search = defineCommand5({
       meta: {
         name: "search",
         description: "Search community skills"
@@ -2504,24 +3231,24 @@ var init_skills2 = __esm({
         const results = await searchCatalog(args.keyword);
         if (results.length === 0) {
           console.log(`No skills found for "${args.keyword}".`);
-          console.log(`  Browse the catalog at: ${pc8.cyan("https://skills.sh/")}`);
+          console.log(`  Browse the catalog at: ${pc10.cyan("https://skills.sh/")}`);
           return;
         }
         console.log();
         console.log(`${results.length} skill(s) matching "${args.keyword}":`);
         console.log();
         for (const skill of results) {
-          console.log(`  ${pc8.bold(skill.name)}`);
+          console.log(`  ${pc10.bold(skill.name)}`);
           console.log(`  ${skill.description}`);
-          console.log(`  ${pc8.dim(skill.repo)}`);
+          console.log(`  ${pc10.dim(skill.repo)}`);
           if (skill.tags.length > 0) {
-            console.log(`  ${pc8.dim(skill.tags.join(", "))}`);
+            console.log(`  ${pc10.dim(skill.tags.join(", "))}`);
           }
           console.log();
         }
       }
     });
-    add = defineCommand4({
+    add = defineCommand5({
       meta: {
         name: "add",
         description: "Install a community skill"
@@ -2537,7 +3264,7 @@ var init_skills2 = __esm({
         await addSkill(process.cwd(), args.source);
       }
     });
-    remove = defineCommand4({
+    remove = defineCommand5({
       meta: {
         name: "remove",
         description: "Remove an installed community skill"
@@ -2553,7 +3280,7 @@ var init_skills2 = __esm({
         await removeSkill(process.cwd(), args.name);
       }
     });
-    skills_default = defineCommand4({
+    skills_default = defineCommand5({
       meta: {
         name: "skills",
         description: "Manage FlyDocs skills (list, search, add, remove)"
@@ -2573,11 +3300,71 @@ var connect_exports = {};
 __export(connect_exports, {
   default: () => connect_default
 });
-import { defineCommand as defineCommand5 } from "citty";
-import { text as text2, confirm as confirm4, isCancel as isCancel5, cancel as cancel4 } from "@clack/prompts";
-import pc9 from "picocolors";
-import { readFile as readFile9, writeFile as writeFile5, appendFile as appendFile2 } from "fs/promises";
-import { join as join14 } from "path";
+import { defineCommand as defineCommand6 } from "citty";
+import { text as text2, confirm as confirm5, isCancel as isCancel6, cancel as cancel5 } from "@clack/prompts";
+import pc11 from "picocolors";
+import { readFile as readFile11, writeFile as writeFile7, appendFile as appendFile2 } from "fs/promises";
+import { join as join17 } from "path";
+function detectKeyType(key) {
+  if (key.startsWith("fdk_")) return "relay";
+  if (key.startsWith("lin_api_")) return "direct";
+  return "unknown";
+}
+async function validateRelayKey(apiKey) {
+  const baseUrl = process.env.FLYDOCS_RELAY_URL?.replace(/\/$/, "") ?? "https://app.flydocs.ai/api/relay";
+  const response = await fetch(`${baseUrl}/auth/validate`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!response.ok) return { valid: false };
+  const data = await response.json();
+  if (!data.valid) return { valid: false };
+  return { valid: true, org: data.org ?? "your organization" };
+}
+async function validateLinearKey(apiKey) {
+  const response = await fetch("https://api.linear.app/graphql", {
+    method: "POST",
+    headers: {
+      Authorization: apiKey,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ query: "{ viewer { id name email } }" }),
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!response.ok) return { valid: false };
+  const data = await response.json();
+  if (!data.data?.viewer) return { valid: false };
+  return {
+    valid: true,
+    name: data.data.viewer.name,
+    email: data.data.viewer.email
+  };
+}
+async function storeEnvKey(targetDir, envVarName, value) {
+  const envPath = join17(targetDir, ".env");
+  const envLocalPath = join17(targetDir, ".env.local");
+  const targetEnvPath = await pathExists(envLocalPath) ? envLocalPath : envPath;
+  const pattern = new RegExp(`${envVarName}=.*`);
+  if (await pathExists(targetEnvPath)) {
+    const envContent = await readFile11(targetEnvPath, "utf-8");
+    if (pattern.test(envContent)) {
+      const updated = envContent.replace(pattern, `${envVarName}=${value}`);
+      await writeFile7(targetEnvPath, updated, "utf-8");
+    } else {
+      await appendFile2(targetEnvPath, `
+${envVarName}=${value}
+`);
+    }
+  } else {
+    await writeFile7(targetEnvPath, `${envVarName}=${value}
+`, "utf-8");
+  }
+  return targetEnvPath === envLocalPath ? ".env.local" : ".env";
+}
 var connect_default;
 var init_connect = __esm({
   "src/commands/connect.ts"() {
@@ -2586,10 +3373,10 @@ var init_connect = __esm({
     init_fs_ops();
     init_template();
     init_ui();
-    connect_default = defineCommand5({
+    connect_default = defineCommand6({
       meta: {
         name: "connect",
-        description: "Connect FlyDocs to a cloud provider (Linear)"
+        description: "Connect FlyDocs to a cloud provider"
       },
       args: {
         path: {
@@ -2606,16 +3393,16 @@ var init_connect = __esm({
         },
         key: {
           type: "string",
-          description: "Linear API key (skips prompt)"
+          description: "API key (fdk_ for relay, lin_api_ for direct Linear)"
         }
       },
       async run({ args }) {
         const targetDir = args.path ?? process.cwd();
-        const configPath = join14(targetDir, ".flydocs", "config.json");
+        const configPath = join17(targetDir, ".flydocs", "config.json");
         if (!await pathExists(configPath)) {
           printError("Not a FlyDocs project (.flydocs/config.json not found).");
           console.log(
-            `  Run ${pc9.cyan("flydocs")} first to install FlyDocs in this project.`
+            `  Run ${pc11.cyan("flydocs")} first to install FlyDocs in this project.`
           );
           process.exit(1);
         }
@@ -2623,87 +3410,85 @@ var init_connect = __esm({
         if (config.tier === "cloud") {
           printInfo("This project is already connected to the cloud tier.");
           console.log();
-          const reconnect = await confirm4({
+          const reconnect = await confirm5({
             message: "Want to update your API key?"
           });
-          if (isCancel5(reconnect) || !reconnect) {
+          if (isCancel6(reconnect) || !reconnect) {
             console.log(`  No changes made.`);
             return;
           }
         }
         console.log();
-        console.log(`  ${pc9.bold("Connect to Linear")}`);
+        console.log(`  ${pc11.bold("Connect to FlyDocs Cloud")}`);
         console.log();
         console.log(
-          `  ${pc9.dim("Get your API key from: Linear \u2192 Settings \u2192 API \u2192 Personal API keys")}`
+          `  ${pc11.dim("FlyDocs API key (fdk_...): Get from your FlyDocs dashboard")}`
+        );
+        console.log(
+          `  ${pc11.dim("Linear API key (lin_api_...): Get from Linear \u2192 Settings \u2192 API")}`
         );
         console.log();
         let apiKey = args.key ?? "";
         if (!apiKey) {
           const keyInput = await text2({
-            message: "Enter your Linear API key",
-            placeholder: "lin_api_...",
+            message: "Enter your API key",
+            placeholder: "fdk_... or lin_api_...",
             validate(value) {
               if (!value.trim()) return "API key is required";
-              if (!value.startsWith("lin_api_"))
-                return "Linear API keys start with lin_api_";
+              const type = detectKeyType(value.trim());
+              if (type === "unknown")
+                return "Key must start with fdk_ (FlyDocs) or lin_api_ (Linear)";
               return void 0;
             }
           });
-          if (isCancel5(keyInput)) {
-            cancel4("Connection cancelled.");
+          if (isCancel6(keyInput)) {
+            cancel5("Connection cancelled.");
             process.exit(0);
           }
-          apiKey = keyInput;
+          apiKey = keyInput.trim();
         }
-        printInfo("Validating API key...");
-        try {
-          const response = await fetch("https://api.linear.app/graphql", {
-            method: "POST",
-            headers: {
-              Authorization: apiKey,
-              "Content-Type": "application/json"
-            },
-            body: JSON.stringify({ query: "{ viewer { id name email } }" }),
-            signal: AbortSignal.timeout(15e3)
-          });
-          if (!response.ok) {
-            throw new Error(`HTTP ${response.status}`);
-          }
-          const data = await response.json();
-          if (!data.data?.viewer) {
-            throw new Error("Invalid response");
-          }
-          const viewer = data.data.viewer;
-          printStatus(`Authenticated as ${pc9.bold(viewer.name)} (${viewer.email})`);
-        } catch {
-          printError("Invalid API key or network error.");
-          console.log(`  Check your key and try again.`);
+        const keyType = detectKeyType(apiKey);
+        if (keyType === "unknown") {
+          printError("Unrecognized key format. Expected fdk_ or lin_api_ prefix.");
           process.exit(1);
         }
-        const envPath = join14(targetDir, ".env");
-        const envLocalPath = join14(targetDir, ".env.local");
-        const targetEnvPath = await pathExists(envLocalPath) ? envLocalPath : envPath;
-        if (await pathExists(targetEnvPath)) {
-          const envContent = await readFile9(targetEnvPath, "utf-8");
-          if (envContent.includes("LINEAR_API_KEY=")) {
-            const updated = envContent.replace(
-              /LINEAR_API_KEY=.*/,
-              `LINEAR_API_KEY=${apiKey}`
+        printInfo("Validating API key...");
+        if (keyType === "relay") {
+          try {
+            const result = await validateRelayKey(apiKey);
+            if (!result.valid) {
+              printError("Invalid API key or relay API unreachable.");
+              console.log(`  Check your key and try again.`);
+              process.exit(1);
+            }
+            printStatus(`Connected to ${pc11.bold(result.org)}`);
+          } catch {
+            printError(
+              "Could not reach relay API. Check your network and try again."
             );
-            await writeFile5(targetEnvPath, updated, "utf-8");
-          } else {
-            await appendFile2(targetEnvPath, `
-LINEAR_API_KEY=${apiKey}
-`);
+            process.exit(1);
           }
+          const envFile = await storeEnvKey(targetDir, "FLYDOCS_API_KEY", apiKey);
+          printStatus(`API key stored in ${pc11.dim(envFile)}`);
         } else {
-          await writeFile5(targetEnvPath, `LINEAR_API_KEY=${apiKey}
-`, "utf-8");
+          try {
+            const result = await validateLinearKey(apiKey);
+            if (!result.valid) {
+              printError("Invalid API key or network error.");
+              console.log(`  Check your key and try again.`);
+              process.exit(1);
+            }
+            printStatus(
+              `Authenticated as ${pc11.bold(result.name)} (${result.email})`
+            );
+          } catch {
+            printError("Invalid API key or network error.");
+            console.log(`  Check your key and try again.`);
+            process.exit(1);
+          }
+          const envFile = await storeEnvKey(targetDir, "LINEAR_API_KEY", apiKey);
+          printStatus(`API key stored in ${pc11.dim(envFile)}`);
         }
-        printStatus(
-          `API key stored in ${pc9.dim(targetEnvPath === envLocalPath ? ".env.local" : ".env")}`
-        );
         const wasLocal = config.tier === "local";
         config.tier = "cloud";
         config.provider = config.provider ?? { type: "linear", teamId: null };
@@ -2715,16 +3500,16 @@ LINEAR_API_KEY=${apiKey}
             const templateDir = await resolveTemplatePath(
               args["local-source"] || void 0
             );
-            const templateSkillsDir = join14(templateDir, ".claude", "skills");
-            const skillsDir = join14(targetDir, ".claude", "skills");
+            const templateSkillsDir = join17(templateDir, ".claude", "skills");
+            const skillsDir = join17(targetDir, ".claude", "skills");
             await replaceDirectory(
-              join14(templateSkillsDir, "flydocs-cloud"),
-              join14(skillsDir, "flydocs-cloud")
+              join17(templateSkillsDir, "flydocs-cloud"),
+              join17(skillsDir, "flydocs-cloud")
             );
-            const { rm: rm5 } = await import("fs/promises");
-            const localSkillDir = join14(skillsDir, "flydocs-local");
+            const { rm: rm6 } = await import("fs/promises");
+            const localSkillDir = join17(skillsDir, "flydocs-local");
             if (await pathExists(localSkillDir)) {
-              await rm5(localSkillDir, { recursive: true, force: true });
+              await rm6(localSkillDir, { recursive: true, force: true });
             }
             printStatus("Cloud mechanism skill installed");
           } catch {
@@ -2735,14 +3520,14 @@ LINEAR_API_KEY=${apiKey}
         }
         console.log();
         console.log(
-          `  ${pc9.bold("Connected!")} Your project now syncs with Linear.`
+          `  ${pc11.bold("Connected!")} Your project is now on the cloud tier.`
         );
         console.log();
         console.log(`  Next steps:`);
         console.log(
-          `    1. Run ${pc9.cyan("/flydocs-setup")} in your IDE to configure your Linear project`
+          `    1. Run ${pc11.cyan("/flydocs-setup")} in your IDE to configure your project`
         );
-        console.log(`    2. Run ${pc9.cyan("/start-session")} to begin working`);
+        console.log(`    2. Run ${pc11.cyan("/start-session")} to begin working`);
         console.log();
       }
     });
@@ -2754,15 +3539,15 @@ var upgrade_exports = {};
 __export(upgrade_exports, {
   default: () => upgrade_default
 });
-import { defineCommand as defineCommand6 } from "citty";
-import pc10 from "picocolors";
+import { defineCommand as defineCommand7 } from "citty";
+import pc12 from "picocolors";
 var upgrade_default;
 var init_upgrade = __esm({
   "src/commands/upgrade.ts"() {
     "use strict";
     init_config();
     init_fs_ops();
-    upgrade_default = defineCommand6({
+    upgrade_default = defineCommand7({
       meta: {
         name: "upgrade",
         description: "Learn about FlyDocs Cloud tier and upgrade from local"
@@ -2791,38 +3576,40 @@ var init_upgrade = __esm({
         console.log();
         if (currentTier === "cloud") {
           console.log(
-            `  ${pc10.green("\u2713")} You're already on the ${pc10.bold("cloud")} tier.`
+            `  ${pc12.green("\u2713")} You're already on the ${pc12.bold("cloud")} tier.`
           );
           console.log();
           console.log(
             `  Your issues sync with Linear via the cloud mechanism skill.`
           );
           console.log(
-            `  Run ${pc10.cyan("flydocs connect")} to update your connection settings.`
+            `  Run ${pc12.cyan("flydocs connect")} to update your connection settings.`
           );
           console.log();
           return;
         }
-        console.log(`  ${pc10.bold("FlyDocs Cloud Tier")}`);
+        console.log(`  ${pc12.bold("FlyDocs Cloud Tier")}`);
         console.log();
-        console.log(`  You're currently on the ${pc10.yellow("local")} tier.`);
+        console.log(`  You're currently on the ${pc12.yellow("local")} tier.`);
         console.log(`  Upgrade to cloud for:`);
         console.log();
         console.log(
-          `    ${pc10.cyan("\u2192")} Issue sync with Linear (Jira coming soon)`
+          `    ${pc12.cyan("\u2192")} Issue sync with Linear (Jira coming soon)`
         );
-        console.log(`    ${pc10.cyan("\u2192")} Project milestones and cycle management`);
-        console.log(`    ${pc10.cyan("\u2192")} Team assignment and priority tracking`);
-        console.log(`    ${pc10.cyan("\u2192")} Project health updates and dashboards`);
-        console.log(`    ${pc10.cyan("\u2192")} Cross-project issue linking`);
+        console.log(`    ${pc12.cyan("\u2192")} Project milestones and cycle management`);
+        console.log(`    ${pc12.cyan("\u2192")} Team assignment and priority tracking`);
+        console.log(`    ${pc12.cyan("\u2192")} Project health updates and dashboards`);
+        console.log(`    ${pc12.cyan("\u2192")} Cross-project issue linking`);
+        console.log();
+        console.log(`  ${pc12.bold("How to upgrade:")}`);
         console.log();
-        console.log(`  ${pc10.bold("How to upgrade:")}`);
+        console.log(`    Option 1: Run ${pc12.cyan("/flydocs-upgrade")} in your IDE`);
+        console.log(`              Guided migration with issue transfer`);
         console.log();
-        console.log(`    1. Sign up at ${pc10.cyan("https://www.flydocs.ai")}`);
-        console.log(`    2. Get your Linear API key from Linear \u2192 Settings \u2192 API`);
         console.log(
-          `    3. Run ${pc10.cyan("flydocs connect")} to connect your project`
+          `    Option 2: Run ${pc12.cyan("flydocs connect")} from terminal`
         );
+        console.log(`              Quick tier swap (no issue migration)`);
         console.log();
       }
     });
@@ -2834,23 +3621,23 @@ var self_update_exports = {};
 __export(self_update_exports, {
   default: () => self_update_default
 });
-import { defineCommand as defineCommand7 } from "citty";
+import { defineCommand as defineCommand8 } from "citty";
 import { execSync } from "child_process";
-import pc11 from "picocolors";
+import pc13 from "picocolors";
 var self_update_default;
 var init_self_update = __esm({
   "src/commands/self-update.ts"() {
     "use strict";
     init_constants();
     init_ui();
-    self_update_default = defineCommand7({
+    self_update_default = defineCommand8({
       meta: {
         name: "self-update",
         description: "Update FlyDocs CLI to the latest version"
       },
       async run() {
         console.log();
-        console.log(`  Updating ${pc11.cyan(PACKAGE_NAME)}...`);
+        console.log(`  Updating ${pc13.cyan(PACKAGE_NAME)}...`);
         console.log();
         try {
           execSync(`npm install -g ${PACKAGE_NAME}@beta`, {
@@ -2870,17 +3657,117 @@ var init_self_update = __esm({
   }
 });
 
+// src/commands/telemetry.ts
+var telemetry_exports = {};
+__export(telemetry_exports, {
+  default: () => telemetry_default
+});
+import { defineCommand as defineCommand9 } from "citty";
+import pc14 from "picocolors";
+var enable, disable, status, telemetry_default;
+var init_telemetry2 = __esm({
+  "src/commands/telemetry.ts"() {
+    "use strict";
+    init_telemetry();
+    init_ui();
+    enable = defineCommand9({
+      meta: {
+        name: "enable",
+        description: "Enable anonymous usage analytics"
+      },
+      async run() {
+        try {
+          await setEnabled(true);
+          printStatus("Telemetry enabled");
+        } catch {
+          printError("Failed to update telemetry settings");
+          process.exit(1);
+        }
+      }
+    });
+    disable = defineCommand9({
+      meta: {
+        name: "disable",
+        description: "Disable anonymous usage analytics"
+      },
+      async run() {
+        try {
+          await setEnabled(false);
+          printStatus("Telemetry disabled");
+          printInfo(
+            "You can also set FLYDOCS_TELEMETRY=0 in your shell environment."
+          );
+        } catch {
+          printError("Failed to update telemetry settings");
+          process.exit(1);
+        }
+      }
+    });
+    status = defineCommand9({
+      meta: {
+        name: "status",
+        description: "Show current telemetry status"
+      },
+      async run() {
+        const info = await getStatus();
+        console.log();
+        console.log(pc14.bold("Telemetry Status"));
+        console.log();
+        const effectivelyEnabled = info.enabled && !info.envOverride;
+        console.log(
+          `  Enabled:        ${effectivelyEnabled ? pc14.green("yes") : pc14.yellow("no")}`
+        );
+        if (info.envOverride) {
+          console.log(
+            `  Env override:   ${pc14.yellow("FLYDOCS_TELEMETRY=0 (disabled via env)")}`
+          );
+        }
+        if (info.anonymousId) {
+          console.log(`  Anonymous ID:   ${pc14.dim(info.anonymousId)}`);
+        } else {
+          console.log(
+            `  Anonymous ID:   ${pc14.dim("(not yet created \u2014 generated on first run)")}`
+          );
+        }
+        console.log();
+        console.log(
+          pc14.dim(
+            "  FlyDocs collects anonymous usage analytics to improve the CLI."
+          )
+        );
+        console.log(
+          pc14.dim("  No personal data, file contents, or code is ever collected.")
+        );
+        console.log();
+      }
+    });
+    telemetry_default = defineCommand9({
+      meta: {
+        name: "telemetry",
+        description: "Manage anonymous usage analytics (enable, disable, status)"
+      },
+      subCommands: {
+        enable,
+        disable,
+        status
+      }
+    });
+  }
+});
+
 // src/cli.ts
 init_constants();
-import { defineCommand as defineCommand8, runMain } from "citty";
+import { defineCommand as defineCommand10, runMain } from "citty";
 var SUB_COMMANDS = /* @__PURE__ */ new Set([
   "install",
   "update",
+  "uninstall",
   "setup",
   "skills",
   "connect",
   "upgrade",
-  "self-update"
+  "self-update",
+  "telemetry"
 ]);
 var userArgs = process.argv.slice(2);
 var hasMetaFlag = userArgs.some(
@@ -2890,7 +3777,7 @@ var firstPositional = userArgs.find((a) => !a.startsWith("-"));
 if (!hasMetaFlag && (!firstPositional || !SUB_COMMANDS.has(firstPositional))) {
   process.argv.splice(2, 0, "install");
 }
-var main = defineCommand8({
+var main = defineCommand10({
   meta: {
     name: CLI_NAME,
     version: CLI_VERSION,
@@ -2899,11 +3786,13 @@ var main = defineCommand8({
   subCommands: {
     install: () => Promise.resolve().then(() => (init_install(), install_exports)).then((m) => m.default),
     update: () => Promise.resolve().then(() => (init_update(), update_exports)).then((m) => m.default),
+    uninstall: () => Promise.resolve().then(() => (init_uninstall(), uninstall_exports)).then((m) => m.default),
     setup: () => Promise.resolve().then(() => (init_setup(), setup_exports)).then((m) => m.default),
     skills: () => Promise.resolve().then(() => (init_skills2(), skills_exports)).then((m) => m.default),
     connect: () => Promise.resolve().then(() => (init_connect(), connect_exports)).then((m) => m.default),
     upgrade: () => Promise.resolve().then(() => (init_upgrade(), upgrade_exports)).then((m) => m.default),
-    "self-update": () => Promise.resolve().then(() => (init_self_update(), self_update_exports)).then((m) => m.default)
+    "self-update": () => Promise.resolve().then(() => (init_self_update(), self_update_exports)).then((m) => m.default),
+    telemetry: () => Promise.resolve().then(() => (init_telemetry2(), telemetry_exports)).then((m) => m.default)
   }
 });
 runMain(main);