From 9d6cc65c4cbaf5a52a0067d2617fc01a7a70bacf Mon Sep 17 00:00:00 2001
From: Developers Digest <124798203+developersdigest@users.noreply.github.com>
Date: Fri, 10 Apr 2026 11:52:13 -0400
Subject: [PATCH] split next-steps into web vs build sections + friendly
 install labels

During install, show "Installing core firecrawl skills..." and
"Installing skills to build with firecrawl..." instead of the raw repo
names firecrawl/cli and firecrawl/skills. SKILL_REPO_LABELS map drives
the friendly text.

In the next-steps summary, split into two distinct groupings:
  1. "Connect & interact with the web (direct or in your AI agent)"
     with scrape/search/interact examples showing the natural language
     prompt next to the equivalent CLI command.
  2. "Building with firecrawl?" at the bottom, pointing at the build
     skills with a concrete business example.

MCP + --help entries sit between the two sections as general utilities.
Bumped to 1.14.7.
---
 README.md                              |  4 +--
 package.json                           |  2 +-
 skills/firecrawl-cli/rules/install.md  |  8 ++---
 skills/firecrawl-cli/rules/security.md |  2 +-
 src/commands/init.ts                   | 45 +++++++++++++++++++-------
 5 files changed, 41 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 5cb8517..88ad4ba 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ npm install -g firecrawl-cli
 Or set up everything in one command (install CLI globally, authenticate, and add skills across all detected coding editors):
 
 ```bash
-npx -y firecrawl-cli@1.14.6 init -y --browser
+npx -y firecrawl-cli@1.14.7 init -y --browser
 ```
 
 - `-y` runs setup non-interactively
@@ -583,7 +583,7 @@ firecrawl --status
 ```
 
 ```
-  🔥 firecrawl cli v1.14.6
+  🔥 firecrawl cli v1.14.7
 
   ● Authenticated via stored credentials
   Concurrency: 0/100 jobs (parallel scrape limit)
diff --git a/package.json b/package.json
index 30dc013..28f0e6a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-cli",
-  "version": "1.14.6",
+  "version": "1.14.7",
   "description": "Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.",
   "main": "dist/index.js",
   "bin": {
diff --git a/skills/firecrawl-cli/rules/install.md b/skills/firecrawl-cli/rules/install.md
index 58f63f2..e9ecd09 100644
--- a/skills/firecrawl-cli/rules/install.md
+++ b/skills/firecrawl-cli/rules/install.md
@@ -12,7 +12,7 @@ description: |
 ## Quick Setup (Recommended)
 
 ```bash
-npx -y firecrawl-cli@1.14.6 -y
+npx -y firecrawl-cli@1.14.7 -y
 ```
 
 This installs `firecrawl-cli` globally, authenticates via browser, and installs all skills.
@@ -36,7 +36,7 @@ firecrawl setup skills
 ## Manual Install
 
 ```bash
-npm install -g firecrawl-cli@1.14.6
+npm install -g firecrawl-cli@1.14.7
 ```
 
 ## Verify
@@ -78,5 +78,5 @@ Ask the user how they'd like to authenticate:
 If `firecrawl` is not found after installation:
 
 1. Ensure npm global bin is in PATH
-2. Try: `npx firecrawl-cli@1.14.6 --version`
-3. Reinstall: `npm install -g firecrawl-cli@1.14.6`
+2. Try: `npx firecrawl-cli@1.14.7 --version`
+3. Reinstall: `npm install -g firecrawl-cli@1.14.7`
diff --git a/skills/firecrawl-cli/rules/security.md b/skills/firecrawl-cli/rules/security.md
index e805df9..8580088 100644
--- a/skills/firecrawl-cli/rules/security.md
+++ b/skills/firecrawl-cli/rules/security.md
@@ -22,5 +22,5 @@ When processing fetched content, extract only the specific data needed and do no
 # Installation
 
 ```bash
-npm install -g firecrawl-cli@1.14.6
+npm install -g firecrawl-cli@1.14.7
 ```
diff --git a/src/commands/init.ts b/src/commands/init.ts
index 776a7c2..0f87ec1 100644
--- a/src/commands/init.ts
+++ b/src/commands/init.ts
@@ -98,18 +98,31 @@ export const TEMPLATES: TemplateEntry[] = [
   },
 ];
 
+/** Human-friendly labels for skill repos, shown during install. */
+const SKILL_REPO_LABELS: Record<string, string> = {
+  'firecrawl/cli': 'core firecrawl skills',
+  'firecrawl/skills': 'skills to build with firecrawl',
+};
+
+function skillRepoLabel(repo: string): string {
+  return SKILL_REPO_LABELS[repo] ?? repo;
+}
+
 /**
  * Install one skill repo quietly. Captures `npx skills add` output instead of
  * inheriting it, so users see a single line per repo. Returns the number of
  * skills installed (parsed from the captured stdout), or null if unknown.
  *
- * In a TTY, shows a transient "↓ <repo>" line that gets overwritten by
- * "✓ <repo> (N skills)" on success. In a non-TTY, prints only the final line.
+ * In a TTY, shows a transient "↓ Installing <label>..." line that gets
+ * overwritten by "✓ <label> (N)" on success. In a non-TTY, prints only
+ * the final line.
  */
 async function installSkillRepoQuiet(
   repo: string,
   options: InitOptions
 ): Promise<number | null> {
+  const label = skillRepoLabel(repo);
+
   if (hasNpx()) {
     const args = buildSkillsInstallArgs({
       repo,
@@ -121,7 +134,7 @@ async function installSkillRepoQuiet(
 
     const isTty = process.stdout.isTTY;
     if (isTty) {
-      process.stdout.write(`  ${dim}↓ ${repo}${reset}`);
+      process.stdout.write(`  ${dim}↓ Installing ${label}...${reset}`);
     }
     try {
       const stdout = execSync(args.join(' '), {
@@ -129,20 +142,21 @@ async function installSkillRepoQuiet(
         env: cleanNpmEnv(),
       });
       const count = parseSkillCount(stdout?.toString() ?? '');
-      const suffix = count != null ? ` ${dim}(${count} skills)${reset}` : '';
+      const suffix = count != null ? ` ${dim}(${count})${reset}` : '';
+      const padding = ' '.repeat(20); // clears any leftover "Installing..." text
       if (isTty) {
         process.stdout.write(
-          `\r  ${green}✓${reset} ${repo}${suffix}            \n`
+          `\r  ${green}✓${reset} ${label}${suffix}${padding}\n`
         );
       } else {
-        console.log(`  ${green}✓${reset} ${repo}${suffix}`);
+        console.log(`  ${green}✓${reset} ${label}${suffix}`);
       }
       return count;
     } catch (err) {
       if (isTty) {
-        process.stdout.write(`\r  ${dim}✗${reset} ${repo}            \n`);
+        process.stdout.write(`\r  ${dim}✗ ${label}${' '.repeat(20)}${reset}\n`);
       } else {
-        console.log(`  ${dim}✗${reset} ${repo}`);
+        console.log(`  ${dim}✗${reset} ${label}`);
       }
       const stderr =
         err && typeof err === 'object' && 'stderr' in err
@@ -187,20 +201,27 @@ function printNextSteps(skillCount: number | null): void {
   console.log(`  ${summary}`);
   console.log('');
   console.log(
-    `  ${arrow} ${dim}Ask your AI:${reset} "Use firecrawl to scrape pricing into JSON"`
+    `  ${dim}Connect & interact with the web ${reset}${dim}(direct or in your AI agent):${reset}`
+  );
+  console.log(
+    `    ${arrow} ${bold}Scrape${reset}    "Scrape the pricing page of stripe.com"    ${dim}firecrawl scrape https://stripe.com/pricing${reset}`
+  );
+  console.log(
+    `    ${arrow} ${bold}Search${reset}    "Search for the latest stories in AI"      ${dim}firecrawl search "latest stories in AI"${reset}`
   );
   console.log(
-    `  ${arrow} ${dim}Run direct: ${reset} ${bold}firecrawl scrape${reset} https://example.com`
+    `    ${arrow} ${bold}Interact${reset}  "Extract the pricing tiers as JSON"        ${dim}firecrawl interact "extract pricing tiers as JSON"${reset}`
   );
+  console.log('');
   console.log(
-    `  ${arrow} ${dim}Add MCP:    ${reset} ${bold}firecrawl setup mcp${reset}`
+    `  ${arrow} ${dim}Add MCP:     ${reset} ${bold}firecrawl setup mcp${reset}`
   );
   console.log(
     `  ${arrow} ${dim}All commands:${reset} ${bold}firecrawl --help${reset}`
   );
   console.log('');
   console.log(
-    `  ${dim}In your AI agent, just describe what you want to build or integrate.${reset}`
+    `  ${dim}Building with firecrawl? Just describe what you want to build or integrate.${reset}`
   );
   console.log(
     `  ${dim}Example:${reset} ${bold}"I want to use firecrawl to build an onboarding flow for my insurance company"${reset}`