@flydocs/cli 0.5.0-beta.11 → 0.5.0-beta.13

package/dist/cli.js

@@ -15,7 +15,7 @@ var CLI_VERSION, CLI_NAME, PACKAGE_NAME;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.5.0-beta.11";
+    CLI_VERSION = "0.5.0-beta.13";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
   }
@@ -42,9 +42,7 @@ async function ensureDirectories(targetDir, tier) {
   const dirs = [
     ".flydocs",
     ".claude/skills",
-    ".claude/agents",
     ".claude/commands",
-    ".cursor/agents",
     ".cursor/commands",
     ".cursor/rules",
     "flydocs/context",
@@ -139,6 +137,59 @@ import pc2 from "picocolors";
 function hyperlink(text3, url) {
   return `\x1B]8;;${url}\x07${text3}\x1B]8;;\x07`;
 }
+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 +203,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 +230,43 @@ 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("Join the community")} ${dim("\u2014 bugs, ideas, and updates")}`
+  );
+  console.log(
+    `  ${hyperlink(pc2.cyan("discord.com/invite/YAkjePmZTQ"), discordUrl)}`
+  );
+  console.log();
+  console.log(
+    `  ${dim("Docs and updates:")} ${hyperlink(pc2.cyan("flydocs.ai"), siteUrl)}`
   );
-  console.log(`  ${hyperlink(pc2.cyan("https://www.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"
+    ];
   }
 });
 
@@ -348,9 +407,9 @@ async function replaceOwnedSkills(templateDir, targetDir, tier) {
   }
 }
 async function copyCursorRules(targetDir) {
-  const { mkdir: mkdir6 } = await import("fs/promises");
+  const { mkdir: mkdir7 } = await import("fs/promises");
   const rulesDir = join4(targetDir, ".cursor", "rules");
-  await mkdir6(rulesDir, { recursive: true });
+  await mkdir7(rulesDir, { recursive: true });
   const workflowRule = join4(
     targetDir,
     ".claude",
@@ -1578,7 +1637,9 @@ __export(install_exports, {
 import { defineCommand } from "citty";
 import { resolve as resolve2 } from "path";
 import { join as join12 } from "path";
+import { mkdir as mkdir5 } 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"() {
@@ -1732,14 +1793,56 @@ 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;
+          }
         }
+        if (installAgents) {
+          const claudeAgentsSrc = join12(templateDir, ".claude", "agents");
+          if (await pathExists(claudeAgentsSrc)) {
+            await mkdir5(join12(targetDir, ".claude", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              claudeAgentsSrc,
+              join12(targetDir, ".claude", "agents")
+            );
+          }
+          const cursorAgentsSrc = join12(templateDir, ".cursor", "agents");
+          if (await pathExists(cursorAgentsSrc)) {
+            await mkdir5(join12(targetDir, ".cursor", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              cursorAgentsSrc,
+              join12(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")
@@ -1752,14 +1855,7 @@ var init_install = __esm({
           join12(templateDir, ".claude", "settings.json"),
           join12(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")
@@ -1768,7 +1864,7 @@ var init_install = __esm({
           join12(templateDir, ".cursor", "hooks.json"),
           join12(targetDir, ".cursor", "hooks.json")
         );
-        printStatus(".cursor/ (agents, commands, hooks)");
+        printStatus(".cursor/ (commands, hooks)");
         await copyCursorRules(targetDir);
         printStatus(".cursor/rules/");
         await copyFile(
@@ -1898,7 +1994,7 @@ 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}`,
@@ -1908,7 +2004,7 @@ var init_install = __esm({
           "  2. Run /flydocs-setup to configure your Linear workspace",
           "  3. Start working with /start-session",
           "",
-          "Documentation: flydocs/README.md"
+          "Docs: https://www.flydocs.ai/docs"
         ];
         let copiedToClipboard = false;
         try {
@@ -2039,9 +2135,9 @@ __export(update_exports, {
 });
 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 { mkdir as mkdir6, cp as cp2, readFile as readFile8, 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"() {
@@ -2189,7 +2285,7 @@ var init_update = __esm({
         const changelogPath = join13(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}`);
@@ -2199,7 +2295,7 @@ 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 });
+        await mkdir6(backupDir, { recursive: true });
         if (hasConfig) {
           await cp2(
             join13(targetDir, ".flydocs", "config.json"),
@@ -2263,24 +2359,63 @@ var init_update = __esm({
           join13(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(
+          join13(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 = join13(templateDir, ".claude", "agents");
+          if (await pathExists(claudeAgentsSrc)) {
+            await mkdir6(join13(targetDir, ".claude", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              claudeAgentsSrc,
+              join13(targetDir, ".claude", "agents")
+            );
+          }
+          const cursorAgentsSrc = join13(templateDir, ".cursor", "agents");
+          if (await pathExists(cursorAgentsSrc)) {
+            await mkdir6(join13(targetDir, ".cursor", "agents"), { recursive: true });
+            await copyDirectoryContents(
+              cursorAgentsSrc,
+              join13(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(
@@ -2411,7 +2546,7 @@ __export(setup_exports, {
   default: () => setup_default
 });
 import { defineCommand as defineCommand3 } from "citty";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 var setup_default;
 var init_setup = __esm({
   "src/commands/setup.ts"() {
@@ -2423,15 +2558,15 @@ var init_setup = __esm({
       },
       run() {
         console.log();
-        console.log(`  ${pc7.bold("FlyDocs Setup")}`);
+        console.log(`  ${pc8.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`
+          `  ${pc8.cyan("Claude Code:")}  Type ${pc8.bold("/flydocs-setup")} in chat`
         );
         console.log(
-          `  ${pc7.cyan("Cursor:")}      Type ${pc7.bold("/flydocs-setup")} in chat`
+          `  ${pc8.cyan("Cursor:")}      Type ${pc8.bold("/flydocs-setup")} in chat`
         );
         console.log();
         console.log(`  This configures your project context, detects your stack,`);
@@ -2448,7 +2583,7 @@ __export(skills_exports, {
   default: () => skills_default
 });
 import { defineCommand as defineCommand4 } from "citty";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 var list, search, add, remove, skills_default;
 var init_skills2 = __esm({
   "src/commands/skills.ts"() {
@@ -2470,19 +2605,19 @@ var init_skills2 = __esm({
         console.log(`${total} skill(s) installed:`);
         if (result.platform.length > 0) {
           console.log();
-          console.log(pc8.bold("Platform"));
+          console.log(pc9.bold("Platform"));
           for (const skill of result.platform) {
             console.log(
-              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc9.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
         if (result.community.length > 0) {
           console.log();
-          console.log(pc8.bold("Community"));
+          console.log(pc9.bold("Community"));
           for (const skill of result.community) {
             console.log(
-              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc9.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
@@ -2505,18 +2640,18 @@ 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: ${pc9.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(`  ${pc9.bold(skill.name)}`);
           console.log(`  ${skill.description}`);
-          console.log(`  ${pc8.dim(skill.repo)}`);
+          console.log(`  ${pc9.dim(skill.repo)}`);
           if (skill.tags.length > 0) {
-            console.log(`  ${pc8.dim(skill.tags.join(", "))}`);
+            console.log(`  ${pc9.dim(skill.tags.join(", "))}`);
           }
           console.log();
         }
@@ -2576,7 +2711,7 @@ __export(connect_exports, {
 });
 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 pc10 from "picocolors";
 import { readFile as readFile9, writeFile as writeFile5, appendFile as appendFile2 } from "fs/promises";
 import { join as join14 } from "path";
 var connect_default;
@@ -2616,7 +2751,7 @@ var init_connect = __esm({
         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 ${pc10.cyan("flydocs")} first to install FlyDocs in this project.`
           );
           process.exit(1);
         }
@@ -2633,10 +2768,10 @@ var init_connect = __esm({
           }
         }
         console.log();
-        console.log(`  ${pc9.bold("Connect to Linear")}`);
+        console.log(`  ${pc10.bold("Connect to Linear")}`);
         console.log();
         console.log(
-          `  ${pc9.dim("Get your API key from: Linear \u2192 Settings \u2192 API \u2192 Personal API keys")}`
+          `  ${pc10.dim("Get your API key from: Linear \u2192 Settings \u2192 API \u2192 Personal API keys")}`
         );
         console.log();
         let apiKey = args.key ?? "";
@@ -2676,7 +2811,7 @@ var init_connect = __esm({
             throw new Error("Invalid response");
           }
           const viewer = data.data.viewer;
-          printStatus(`Authenticated as ${pc9.bold(viewer.name)} (${viewer.email})`);
+          printStatus(`Authenticated as ${pc10.bold(viewer.name)} (${viewer.email})`);
         } catch {
           printError("Invalid API key or network error.");
           console.log(`  Check your key and try again.`);
@@ -2703,7 +2838,7 @@ LINEAR_API_KEY=${apiKey}
 `, "utf-8");
         }
         printStatus(
-          `API key stored in ${pc9.dim(targetEnvPath === envLocalPath ? ".env.local" : ".env")}`
+          `API key stored in ${pc10.dim(targetEnvPath === envLocalPath ? ".env.local" : ".env")}`
         );
         const wasLocal = config.tier === "local";
         config.tier = "cloud";
@@ -2736,14 +2871,14 @@ LINEAR_API_KEY=${apiKey}
         }
         console.log();
         console.log(
-          `  ${pc9.bold("Connected!")} Your project now syncs with Linear.`
+          `  ${pc10.bold("Connected!")} Your project now syncs with Linear.`
         );
         console.log();
         console.log(`  Next steps:`);
         console.log(
-          `    1. Run ${pc9.cyan("/flydocs-setup")} in your IDE to configure your Linear project`
+          `    1. Run ${pc10.cyan("/flydocs-setup")} in your IDE to configure your Linear project`
         );
-        console.log(`    2. Run ${pc9.cyan("/start-session")} to begin working`);
+        console.log(`    2. Run ${pc10.cyan("/start-session")} to begin working`);
         console.log();
       }
     });
@@ -2756,7 +2891,7 @@ __export(upgrade_exports, {
   default: () => upgrade_default
 });
 import { defineCommand as defineCommand6 } from "citty";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 var upgrade_default;
 var init_upgrade = __esm({
   "src/commands/upgrade.ts"() {
@@ -2792,37 +2927,37 @@ var init_upgrade = __esm({
         console.log();
         if (currentTier === "cloud") {
           console.log(
-            `  ${pc10.green("\u2713")} You're already on the ${pc10.bold("cloud")} tier.`
+            `  ${pc11.green("\u2713")} You're already on the ${pc11.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 ${pc11.cyan("flydocs connect")} to update your connection settings.`
           );
           console.log();
           return;
         }
-        console.log(`  ${pc10.bold("FlyDocs Cloud Tier")}`);
+        console.log(`  ${pc11.bold("FlyDocs Cloud Tier")}`);
         console.log();
-        console.log(`  You're currently on the ${pc10.yellow("local")} tier.`);
+        console.log(`  You're currently on the ${pc11.yellow("local")} tier.`);
         console.log(`  Upgrade to cloud for:`);
         console.log();
         console.log(
-          `    ${pc10.cyan("\u2192")} Issue sync with Linear (Jira coming soon)`
+          `    ${pc11.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(`    ${pc11.cyan("\u2192")} Project milestones and cycle management`);
+        console.log(`    ${pc11.cyan("\u2192")} Team assignment and priority tracking`);
+        console.log(`    ${pc11.cyan("\u2192")} Project health updates and dashboards`);
+        console.log(`    ${pc11.cyan("\u2192")} Cross-project issue linking`);
         console.log();
-        console.log(`  ${pc10.bold("How to upgrade:")}`);
+        console.log(`  ${pc11.bold("How to upgrade:")}`);
         console.log();
-        console.log(`    1. Sign up at ${pc10.cyan("https://www.flydocs.ai")}`);
+        console.log(`    1. Sign up at ${pc11.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`
+          `    3. Run ${pc11.cyan("flydocs connect")} to connect your project`
         );
         console.log();
       }
@@ -2837,7 +2972,7 @@ __export(self_update_exports, {
 });
 import { defineCommand as defineCommand7 } from "citty";
 import { execSync } from "child_process";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 var self_update_default;
 var init_self_update = __esm({
   "src/commands/self-update.ts"() {
@@ -2851,7 +2986,7 @@ var init_self_update = __esm({
       },
       async run() {
         console.log();
-        console.log(`  Updating ${pc11.cyan(PACKAGE_NAME)}...`);
+        console.log(`  Updating ${pc12.cyan(PACKAGE_NAME)}...`);
         console.log();
         try {
           execSync(`npm install -g ${PACKAGE_NAME}@beta`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flydocs/cli",
-  "version": "0.5.0-beta.11",
+  "version": "0.5.0-beta.13",
   "type": "module",
   "description": "FlyDocs AI CLI — install, setup, and manage FlyDocs projects",
   "bin": {

package/template/.claude/agents/implementation-agent.md

@@ -1,7 +1,6 @@
 ---
 name: implementation-agent
 description: "Builds features, fixes bugs, writes code. Invoke for implementation, coding, or technical work."
-model: opus
 tools: [Read, Glob, Grep, Bash, Write, Edit, WebFetch, WebSearch]
 skills:
   - flydocs-workflow

package/template/.claude/agents/pm-agent.md

@@ -1,7 +1,6 @@
 ---
 name: pm-agent
 description: "Specs, workflow, issue management. Invoke for capturing, refining, activating, reviewing, closing, or session management."
-model: opus
 tools: [Read, Glob, Grep, Bash, WebFetch]
 disallowedTools: [Write, Edit]
 skills:

package/template/.claude/agents/research-agent.md

@@ -1,7 +1,6 @@
 ---
 name: research-agent
 description: "Codebase exploration and research. Invoke for understanding code structure, finding patterns, or gathering technical context."
-model: sonnet
 tools: [Read, Glob, Grep, WebFetch, WebSearch]
 disallowedTools: [Bash, Write, Edit]
 skills:

package/template/.claude/agents/review-agent.md

@@ -1,7 +1,6 @@
 ---
 name: review-agent
 description: "Code review and quality analysis. Invoke for reviewing implementations, checking quality, or validating acceptance criteria."
-model: sonnet
 tools: [Read, Glob, Grep, Bash]
 disallowedTools: [Write, Edit]
 skills:

package/template/.claude/commands/flydocs-setup.md

@@ -576,20 +576,21 @@ Stage all new and modified FlyDocs files (`.flydocs/`, `.claude/`, `.cursor/`,
 If the user declines, remind them to commit before starting work:
 "No problem — just remember to commit these files before your first session."
 
-### Step 5: Beta CTA
+### Step 5: Community CTA
 
-Always end with the beta call-to-action:
+Always end with the community call-to-action:
 
 ```
 ─────────────────────────────────────────────────────
 
-FlyDocs is in active development. Premium features coming soon:
-  → Cloud sync with Linear, Jira, and more
-  → AI-powered skills and automation
-  → Team analytics and cost intelligence
+What's coming next:
+  → Project management tool sync — Linear, Jira, and more
+  → Web portal — project setup, team visibility, session analytics
+  → Cost intelligence — AI usage tracking and spend analysis
 
-Join the beta for early access and updates:
-  https://www.flydocs.ai?utm_source=cli&utm_medium=setup&utm_campaign=beta
+Join the community:
+  Discord: https://discord.com/invite/YAkjePmZTQ
+  Docs & updates: https://www.flydocs.ai
 
 ─────────────────────────────────────────────────────
 ```

package/template/.flydocs/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.11",
+  "version": "0.5.0-beta.13",
   "sourceRepo": "github.com/plastrlab/flydocs-core",
   "tier": "local",
   "setupComplete": false,

package/template/.flydocs/version

@@ -1 +1 @@
-0.5.0-beta.11
+0.5.0-beta.13

package/template/CHANGELOG.md

@@ -7,6 +7,33 @@ Versioning: [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.5.0-beta.13] — 2026-02-24
+
+### Changed
+
+- **New ASCII banner** — gradient block-letter "FlyDocs" heading with subtle drop shadow,
+  replacing the block mark logo. Pink-to-purple gradient matches brand colors using true
+  color (24-bit) escape sequences. Tagline in bold white, version label in dim.
+
+---
+
+## [0.5.0-beta.12] — 2026-02-24
+
+### Changed
+
+- **Optional sub-agents** — sub-agents (PM, implementation, review, research) are now
+  an opt-in prompt during install and update. Recommended but not required. Existing
+  installs are silently updated on next `flydocs update`.
+- **Removed hardcoded model selections** — Claude Code agent files no longer specify
+  `model: opus` or `model: sonnet`. Agents inherit the user's configured model,
+  matching the Cursor agent behavior.
+- **CLI copy alignment** — banner tagline updated to "Structured context for AI coding
+  tools", beta CTA refocused on Discord community, docs references point to flydocs.ai.
+- **Setup command CTA** — updated to show community links (Discord, flydocs.ai) and
+  upcoming features instead of "join the beta" messaging.
+
+---
+
 ## [0.5.0-beta.11] — 2026-02-23
 
 ### Fixed

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0-beta.11",
+  "version": "0.5.0-beta.13",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",