@insforge/install 0.0.49 → 0.0.51

package/.mcp.json

@@ -7,8 +7,8 @@
         "@insforge/mcp@latest"
       ],
       "env": {
-        "API_KEY": "test123",
-        "API_BASE_URL": "http://localhost:7130"
+        "API_KEY": "ik_478fa0cdd9458ca1e882d918966367a4",
+        "API_BASE_URL": "https://hgqhh6jq.us-west.insforge.app"
       }
     }
   }

package/AGENTS.md

@@ -0,0 +1,99 @@
+---
+description: Instructions building apps with MCP
+globs: *
+alwaysApply: true
+---
+
+# InsForge SDK Documentation - Overview
+
+## What is InsForge?
+
+Backend-as-a-service (BaaS) platform providing:
+
+- **Database**: PostgreSQL with PostgREST API
+- **Authentication**: Email/password + OAuth (Google, GitHub)
+- **Storage**: File upload/download
+- **AI**: Chat completions and image generation (OpenAI-compatible)
+- **Functions**: Serverless function deployment
+
+## Installation
+
+### 🚨 CRITICAL: Follow these steps in order
+
+### Step 1: Download Template
+
+Use the `download-template` MCP tool to create a new project with your backend URL and anon key pre-configured.
+
+### Step 2: Install SDK
+
+```bash
+npm install @insforge/sdk@latest
+```
+
+### Step 3: Create SDK Client
+
+You must create a client instance using `createClient()` with your base URL and anon key:
+
+```javascript
+import { createClient } from '@insforge/sdk';
+
+const client = createClient({
+  baseUrl: 'https://your-app.region.insforge.app',  // Your InsForge backend URL
+  anonKey: 'your-anon-key-here'       // Get this from backend metadata
+});
+
+```
+
+**API BASE URL**: Your API base URL is `https://your-app.region.insforge.app`.
+
+## Getting Detailed Documentation
+
+### 🚨 CRITICAL: Always Fetch Documentation Before Writing Code
+
+Before writing or editing any InsForge integration code, you **MUST** call the `fetch-docs` MCP tool to get the latest SDK documentation. This ensures you have accurate, up-to-date implementation patterns.
+
+### Use the InsForge `fetch-docs` MCP tool to get specific SDK documentation:
+
+Available documentation types:
+
+- `"instructions"` - Essential backend setup (START HERE)
+- `"db-sdk"` - Database operations with SDK
+- **Authentication** - Choose based on implementation:
+  - `"auth-sdk"` - Direct SDK methods for custom auth flows
+  - `"auth-components-react"` - Pre-built auth UI for React+Vite (singlepage App)
+  - `"auth-components-react-router"` - Pre-built auth UI for React(Vite+React Router) (Multipage App)
+  - `"auth-components-nextjs"` - Pre-built auth UI for Nextjs (SSR App)
+- `"storage-sdk"` - File storage operations
+- `"functions-sdk"` - Serverless functions invocation
+- `"ai-integration-sdk"` - AI chat and image generation
+- `"real-time"` - Real-time pub/sub (database + client events) via WebSockets
+- `"deployment"` - Deploy frontend applications via MCP tool
+
+## When to Use SDK vs MCP Tools
+
+### Always SDK for Application Logic:
+
+- Authentication (register, login, logout, profiles)
+- Database CRUD (select, insert, update, delete)
+- Storage operations (upload, download files)
+- AI operations (chat, image generation)
+- Serverless function invocation
+
+### Use MCP Tools for Infrastructure:
+
+- Project scaffolding (`download-template`) - Download starter templates with InsForge integration
+- Backend setup and metadata (`get-backend-metadata`)
+- Database schema management (`run-raw-sql`, `get-table-schema`)
+- Storage bucket creation (`create-bucket`, `list-buckets`, `delete-bucket`)
+- Serverless function deployment (`create-function`, `update-function`, `delete-function`)
+- Frontend deployment (`create-deployment`) - Deploy frontend apps to InsForge hosting
+
+## Important Notes
+
+- For auth: use `auth-sdk` for custom UI, or framework-specific components for pre-built UI
+- SDK returns `{data, error}` structure for all operations
+- Database inserts require array format: `[{...}]`
+- Serverless functions have single endpoint (no subpaths)
+- Storage: Upload files to buckets, store URLs in database
+- AI operations are OpenAI-compatible
+- **EXTRA IMPORTANT**: Use Tailwind CSS 3.4 (do not upgrade to v4). Lock these dependencies in `package.json`

package/dist/index.js

@@ -11,8 +11,9 @@ import {
 
   import yargs from "yargs";
   import { hideBin } from "yargs/helpers";
-  
+
   import pc from "picocolors";
+  import select from "@inquirer/select";
   var { green, red, yellow, cyan } = pc;
 
   // Section header helper
@@ -35,9 +36,25 @@ import {
 ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝
 `;
 
-  function printPostInstallMessage() {
+  // Map client names to display names for better UX
+  const clientDisplayNames = {
+    "claude-code": "Claude Code",
+    "cursor": "Cursor",
+    "windsurf": "Windsurf",
+    "cline": "Cline",
+    "roocode": "Roo Code",
+    "trae": "Trae",
+    "codex": "Codex",
+    "copilot": "GitHub Copilot",
+    "qoder": "Qoder",
+    "antigravity": "Antigravity",
+    "kiro": "Kiro"
+  };
+
+  function printPostInstallMessage(clientName) {
+    const displayName = clientDisplayNames[clientName] || clientName;
     console.log(INSFORGE_LOGO);
-    console.log(green('✓ InsForge MCP is now configured!'));
+    console.log(green(`✓ InsForge MCP is now configured for ${cyan(displayName)}!`));
     console.log();
     console.log('Next steps:');
     console.log('  1. Restart your coding agent to load InsForge');
@@ -59,7 +76,7 @@ import {
     return yargs2.option("client", {
       type: "string",
       description: "Client to use for installation",
-      demandOption: true,
+      demandOption: false,
       choices: clientNames
     }).option("env", {
       type: "string",
@@ -71,11 +88,37 @@ import {
       default: false
     });
   }
+
   async function handler(argv) {
-    if (!argv.client || !clientNames.includes(argv.client)) {
-      logger.error(`Invalid client: ${argv.client}. Available clients: ${clientNames.join(", ")}`);
+    let selectedClient = argv.client;
+
+    // If no client specified, show interactive selection
+    if (!selectedClient) {
+      console.log();
+      console.log(LINE);
+      console.log(`  ${cyan('InsForge MCP Installer')}`);
+      console.log(LINE);
+      console.log();
+
+      selectedClient = await select({
+        message: 'Select your coding agent:',
+        pageSize: 15,
+        loop: false,
+        choices: clientNames.map(name => ({
+          name: clientDisplayNames[name] || name,
+          value: name
+        }))
+      });
+    }
+
+    // Validate client
+    if (!clientNames.includes(selectedClient)) {
+      logger.error(`Invalid client: ${selectedClient}. Available clients: ${clientNames.join(", ")}`);
       return;
     }
+
+    // Update argv.client with selected value for downstream use
+    argv.client = selectedClient;
     const envVars = {};
     if (argv.env && argv.env.length > 0) {
       for (const envVar of argv.env) {
@@ -319,7 +362,7 @@ alwaysApply: true
       }
 
       printHeader('Setup Complete!');
-      printPostInstallMessage();
+      printPostInstallMessage(argv.client);
     } catch (e) {
       logger.error(red(e.message));
     }

package/dist/utils.js

@@ -28,15 +28,15 @@ var platformPaths = {
 var platform = process.platform;
 var { baseDir, vscodePath } = platformPaths[platform];
 var clientPaths = {
-  "claude-code": {
-    type: "file",
-    path: path.join(process.cwd(), ".mcp.json")
-  },
   cursor: {
     type: "file",
     path: path.join(homeDir, ".cursor", "mcp.json"),
     localPath: path.join(process.cwd(), ".cursor", "mcp.json")
   },
+  "claude-code": {
+    type: "file",
+    path: path.join(process.cwd(), ".mcp.json")
+  },
   windsurf: {
     type: "file",
     path: path.join(homeDir, ".codeium", "windsurf", "mcp_config.json")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/install",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "description": "CLI tool for installing Insforge MCP servers across different AI clients",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
+    "@inquirer/select": "^4.4.2",
     "consola": "^3.2.3",
     "node-fetch": "^3.3.2",
     "picocolors": "^1.0.0",