feat: add smithery, super agent man, improve instructions further

Author: rogeriochaves

.specstory/history/2025-11-07_14-06Z-explore-project-and-add-coding-agent.md

@@ -2,7 +2,7 @@
 
 Superagents is a CLI tool and a set of standards for agent building.
 
-It supercharges your coding assistant (Claude Code, Cursor, etc), making it an expert in any agent framework you choose (Agno, Mastra, etc) and all their best practices.
+It supercharges your coding assistant (Claude Code, Cursor, etc), making it an expert in any agent framework you choose (Agno, Mastra, etc) and all their best practices, being able to autodiscover MCP tools to augment your agent.
 
 The Superagent Structure and AGENTS.md ensures industry best practices, making your agent ready for production:
 - [Scenario](https://github.com/langwatch/scenario) agent tests written for every feature to ensure agent behaviour
@@ -76,9 +76,9 @@ The CLI will guide you through:
 
 1. **Programming Language**: Python or TypeScript
 2. **Agent Framework**: Agno (Python) or Mastra (TypeScript)
-3. **Coding Assistant**: Claude Code, Cursor CLI, Kilocode CLI, or None (manual prompt)
-4. **LLM Provider**: OpenAI
-5. **API Keys**: OpenAI and LangWatch
+3. **Coding Assistant**: Claude Code, Cursor, Kilocode CLI, or None (manual prompt)
+4. **LLM Provider**: OpenAI, Anthropic, Gemini, Bedrock, OpenRouter, or Grok
+5. **API Keys**: LLM Provider and LangWatch (required), Smithery (optional)
 6. **Project Goal**: What you want to build
 
 ## Philosophy
@@ -105,9 +105,15 @@ Learn more: https://scenario.langwatch.ai/best-practices/the-agent-testing-pyram
 - **Evaluations**: Measure component performance
 - **MCP Server**: Expert guidance built into your coding assistant
 
+### 🔧 MCP Tool Integration
+
+- **Smithery Toolbox** (optional): When you provide a Smithery API key during setup, your coding agent gets automatic access to MCP tools for enhanced capabilities
+- Auto-configured in `.mcp.json` for seamless integration
+- Your coding assistant can discover and use tools to help build your agent
+
 ### 🤖 Coding Assistant Setup
 
-Your coding assistant (e.g., Claude Code, Cursor CLI, Kilocode CLI) is:
+Your coding assistant (e.g., Claude Code, Cursor, Kilocode CLI) is:
 - **Automatically launched** after project setup with initial prompt
 - Pre-configured with framework-specific knowledge (via MCP or docs)
 - Loaded with LangWatch best practices
@@ -119,13 +125,14 @@ Your coding assistant (e.g., Claude Code, Cursor CLI, Kilocode CLI) is:
 
 - Node.js 18+
 - npm or pnpm
-- A coding assistant CLI (one of the following):
-  - [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code-agent) (`claude`)
-  - [Cursor CLI](https://www.cursor.com/) (`cursor-agent`)
+- A coding assistant (one of the following):
+  - [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code-agent) (`claude` CLI)
+  - [Cursor](https://www.cursor.com/)
   - [Kilocode CLI](https://www.kilocode.ai/) (`kilocode`)
 - API Keys:
-  - OpenAI API key
+  - Your chosen LLM Provider API key
   - LangWatch API key (get one at https://app.langwatch.ai/authorize)
+  - Smithery API key (optional - for MCP tool auto-discovery, get one at https://smithery.ai/account/api-keys)
 
 ## Development
 

.specstory/history/2025-11-08_08-48Z-make-superman-fly-in-ascii-art.md

@@ -43,7 +43,8 @@ First steps:
 Remember:
 - ALWAYS use LangWatch Prompt CLI for prompts (ask the MCP how)
 - ALWAYS write Scenario tests for new features (ask the MCP how)
+- The LLM and LangWatch API keys are already available in the .env file
 - Test everything before considering it done`;
 
-  return `${instructions}\n\nProject Goal: ${config.projectGoal}`;
+  return `${instructions}\n\nAgent Goal: ${config.projectGoal}`;
 };

README.md

@@ -26,32 +26,12 @@ export const kickoffAssistant = async ({
   const prompt = buildInitialPrompt({ config });
   const provider = getCodingAssistantProvider({ assistant: config.codingAssistant });
 
-  // If user selected "none", just show them the initial prompt and exit
-  if (config.codingAssistant === 'none') {
-    console.log(chalk.bold.cyan('\n✨ Project setup complete!\n'));
-    console.log(chalk.gray('When you\'re ready to start, use this initial prompt with your coding assistant:\n'));
-    console.log(chalk.white(`"${prompt}"\n`));
-    console.log(chalk.gray(`Project location: ${projectPath}\n`));
-    return;
-  }
+  console.log(chalk.bold.cyan('\n✨ Project setup complete!\n'));
+  console.log(chalk.gray('Initial prompt:\n'));
+  console.log(chalk.white(`"${prompt}"\n`));
+  console.log(chalk.gray(`Project location: ${projectPath}\n`));
 
-  console.log(chalk.bold.cyan(`\n🤖 Launching ${provider.displayName}...\n`));
-
-  console.log(chalk.gray('\nInitial prompt:'));
-  console.log(chalk.white(`"${prompt}"`));
-
-  try {
-    await provider.launch({ projectPath, prompt });
-    // execSync is blocking, so if we get here, the assistant has finished
-    console.log(chalk.bold.green('\n✨ Session complete!\n'));
-  } catch (error) {
-    if (error instanceof Error) {
-      console.error(chalk.red(`\n❌ Failed to launch ${provider.displayName}: ${error.message}`));
-      console.log(chalk.yellow('\nYou can manually start the assistant by running:'));
-      console.log(chalk.cyan(`  cd ${projectPath}`));
-      console.log(chalk.cyan(`  ${provider.command} "${prompt}"`));
-    }
-    process.exit(1);
-  }
+  // Let the provider handle its own launch behavior
+  await provider.launch({ projectPath, prompt });
 };
 

src/assistant-kickoff/build-initial-prompt.ts

@@ -33,6 +33,21 @@ export const buildMCPConfig = async ({
     args: ["-y", "@langwatch/mcp-server", `--apiKey=${config.langwatchApiKey}`],
   };
 
+  // Add Smithery Toolbox MCP if API key provided
+  if (config.smitheryApiKey) {
+    mcpConfig.mcpServers.toolbox = {
+      command: "npx",
+      args: [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery/toolbox",
+        "--key",
+        config.smitheryApiKey,
+      ],
+    };
+  }
+
   // Add framework-specific MCP if available
   const frameworkProvider = getFrameworkProvider({
     framework: config.framework,

src/assistant-kickoff/kickoff-assistant.ts

@@ -11,22 +11,60 @@ import { kickoffAssistant } from "../assistant-kickoff/kickoff-assistant.js";
 import type { ProjectConfig } from "../types.js";
 
 /**
- * Creates an animated rainbow banner with moving colors
+ * Creates an animated rainbow banner with moving colors and flying Superman
  */
 const showAnimatedBanner = (): Promise<void> => {
   return new Promise((resolve) => {
-    // Define precise RGB colors for a smooth rainbow gradient
+    // Purple gradient for letters
     const colors = [
-      (text: string) => chalk.rgb(255, 0, 0)(text), // Red
-      (text: string) => chalk.rgb(255, 127, 0)(text), // Orange
-      (text: string) => chalk.rgb(255, 255, 0)(text), // Yellow
-      (text: string) => chalk.rgb(0, 255, 0)(text), // Green
-      (text: string) => chalk.rgb(0, 127, 255)(text), // Light Blue
-      (text: string) => chalk.rgb(0, 0, 255)(text), // Blue
-      (text: string) => chalk.rgb(139, 0, 255)(text), // Purple
-      (text: string) => chalk.rgb(255, 0, 255)(text), // Magenta
+      (text: string) => chalk.ansi256(93)(text), // Light purple
+      (text: string) => chalk.ansi256(92)(text), // Medium-light purple
+      (text: string) => chalk.ansi256(91)(text), // Medium purple
+      (text: string) => chalk.ansi256(127)(text), // Deep purple
+      (text: string) => chalk.ansi256(129)(text), // Purple
+      (text: string) => chalk.ansi256(93)(text), // Light purple (cycle back)
     ];
 
+    // Original Superman art
+    const supermanArtOriginal = [
+      "                                  ",
+      "                                  ",
+      "                  ███░            ",
+      "                █████████         ",
+      "             ░████▒░░█████        ",
+      "             ▓██░░░░░░░█░░█       ",
+      "            ░░░░░░░░░▒░░▒░▒       ",
+      "              ░░░░░░░░░░░░        ",
+      "         ░▓▓▓▓▓▓░░░░░░░░░░▒░░░░   ",
+      "     ▓▓▓▓▓▓░░▓▓▓▓▓▒░░░░▒▓▓▓▓░░    ",
+      "       ▓▓▓▓▓▒▓▓▓░▓░▓▓▓░           ",
+      "        ░▓▓▓▓▓▓░▓▓░░              ",
+      "      ▓▓▓▓▓▓▓▓                    ",
+      "      ▓▓░                         ",
+      "                                  ",
+      "                                  ",
+      "                                  ",
+    ];
+
+    // Reverse shading for better display on dark terminals
+    // Swap light and dark characters so face appears light and hair appears dark
+    const reverseShading = (line: string): string => {
+      return line
+        .split('')
+        .map((char) => {
+          switch (char) {
+            case '░': return '█'; // Light shade → Solid
+            case '▒': return '▓'; // Medium shade → Dark shade
+            case '▓': return '▒'; // Dark shade → Medium shade
+            case '█': return '░'; // Solid → Light shade
+            default: return char;
+          }
+        })
+        .join('');
+    };
+
+    const supermanArt = supermanArtOriginal.map(reverseShading);
+
     const superArt = [
       "  ███████╗██╗   ██╗██████╗ ███████╗██████╗ ",
       "  ██╔════╝██║   ██║██╔══██╗██╔════╝██╔══██╗",
@@ -53,20 +91,56 @@ const showAnimatedBanner = (): Promise<void> => {
       console.clear();
       console.log(); // Empty line at top
 
-      // Print SUPER - each line gets one color, colors shift down over time
-      superArt.forEach((line, lineIndex) => {
-        const colorIndex = (colorOffset + lineIndex) % colors.length;
-        console.log(colors[colorIndex](line));
-      });
-
-      console.log(); // Empty line between
-
-      // Print AGENTS - continue the color progression
-      agentsArt.forEach((line, lineIndex) => {
-        const colorIndex =
-          (colorOffset + superArt.length + lineIndex) % colors.length;
-        console.log(colors[colorIndex](line));
-      });
+      // Calculate Superman's vertical offset for flying animation
+      // Using sine wave for smooth up and down motion
+      const flyingOffset = Math.round(
+        2 * Math.sin((frameCount * Math.PI) / 6)
+      );
+
+      // Calculate total height: Superman, SUPER, spacing, and AGENTS
+      const totalTextLines = superArt.length + 1 + agentsArt.length; // +1 for spacing
+      const maxLines = Math.max(supermanArt.length, totalTextLines);
+
+      for (let i = 0; i < maxLines; i++) {
+        let line = "";
+
+        // Add Superman with flying offset
+        const supermanLineIndex = i - flyingOffset;
+        if (
+          supermanLineIndex >= 0 &&
+          supermanLineIndex < supermanArt.length
+        ) {
+          line += supermanArt[supermanLineIndex]; // Use default terminal color
+        } else {
+          // Add empty space when Superman line is out of bounds
+          line += " ".repeat(supermanArt[0].length);
+        }
+
+        // Add spacing between Superman and text
+        line += "  ";
+
+        // Push text down by 2 lines
+        const textLineIndex = i - 2;
+
+        // Add SUPER text (starting at line 2)
+        if (textLineIndex >= 0 && textLineIndex < superArt.length) {
+          const colorIndex = (colorOffset + textLineIndex) % colors.length;
+          line += colors[colorIndex](superArt[textLineIndex]);
+        }
+        // Add empty line between SUPER and AGENTS
+        else if (textLineIndex === superArt.length) {
+          // Just spacing, no text
+        }
+        // Add AGENTS text
+        else if (textLineIndex > superArt.length && textLineIndex - superArt.length - 1 < agentsArt.length) {
+          const agentsLineIndex = textLineIndex - superArt.length - 1;
+          const colorIndex =
+            (colorOffset + superArt.length + agentsLineIndex) % colors.length;
+          line += colors[colorIndex](agentsArt[agentsLineIndex]);
+        }
+
+        console.log(line);
+      }
 
       console.log(); // Empty line at bottom
 

src/builders/mcp-config-builder.ts

@@ -102,6 +102,26 @@ export const collectConfig = async (): Promise<ProjectConfig> => {
       validate: validateLangWatchKey,
     });
 
+    console.log(chalk.gray("\nTo get your Smithery API key (optional), visit:"));
+    console.log(chalk.blue.underline("https://smithery.ai/account/api-keys\n"));
+    console.log(chalk.gray("Smithery enables your coding agent to auto-discover MCP tools to integrate with your agent.\n"));
+
+    const smitheryApiKey = await password({
+      message: "Enter your Smithery API key (Optional - press Enter to skip):",
+      mask: "*",
+      validate: (value) => {
+        // Optional field - empty is valid
+        if (!value || value.trim() === "") {
+          return true;
+        }
+        // If provided, basic validation
+        if (value.length < 10) {
+          return "Smithery API key must be at least 10 characters";
+        }
+        return true;
+      },
+    });
+
     const projectGoal = await input({
       message: "What is your agent going to do?",
       validate: validateProjectGoal,
@@ -115,6 +135,7 @@ export const collectConfig = async (): Promise<ProjectConfig> => {
       llmApiKey,
       llmAdditionalInputs,
       langwatchApiKey,
+      smitheryApiKey: smitheryApiKey && smitheryApiKey.trim() !== "" ? smitheryApiKey : undefined,
       projectGoal,
     };
   } catch (error) {

src/commands/init.ts

@@ -46,7 +46,7 @@ export const detectInstalledAgents = async (): Promise<
 
   return {
     "claude-code": hasClaude,
-    "cursor-cli": hasCursor,
+    cursor: hasCursor,
     kilocode: hasKilocode,
     none: true, // Always available since it doesn't require installation
   };

src/config-collection/collect-config.ts

@@ -76,10 +76,11 @@ const langwatch = new LangWatch({
 });
 
 const prompt = await langwatch.prompts.get("my_prompt")
-Agent(prompt=prompt?.prompt || "")
+Agent(prompt=prompt!.prompt)
 \`\`\`
 
-Prompt fetching is very reliable, there is no need to try/catch around it.
+Prompt fetching is very reliable when using the prompts cli because the files are local (double check they were created with the CLI and are listed on the prompts.json file).
+DO NOT add try/catch around it and DO NOT duplicate the prompt here as a fallback
 
 Explore the prompt management get started and data model docs if you need more advanced usages such as compiled prompts with variables or messages list.