@inkeep/create-agents 0.34.0 → 0.35.0

package/dist/__tests__/e2e/quickstart.test.js

@@ -33,6 +33,7 @@ describe('create-agents quickstart e2e', () => {
             '--local-templates-prefix',
             projectTemplatesPrefix,
             '--skip-inkeep-cli',
+            '--skip-inkeep-mcp',
         ], testDir);
         // Verify the CLI completed successfully
         expect(result.exitCode, `CLI failed with exit code ${result.exitCode}\nstdout: ${result.stdout}\nstderr: ${result.stderr}`).toBe(0);

package/dist/__tests__/utils.test.js

@@ -46,6 +46,8 @@ describe('createAgents - Template and Project ID Logic', () => {
         vi.mocked(fs.pathExists).mockResolvedValue(false);
         vi.mocked(fs.ensureDir).mockResolvedValue(undefined);
         vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+        vi.mocked(fs.writeJson).mockResolvedValue(undefined);
+        vi.mocked(fs.readJson).mockResolvedValue({});
         vi.mocked(fs.mkdir).mockResolvedValue(undefined);
         vi.mocked(fs.remove).mockResolvedValue(undefined);
         // Mock templates
@@ -327,6 +329,8 @@ function setupDefaultMocks() {
     vi.mocked(fs.pathExists).mockResolvedValue(false);
     vi.mocked(fs.ensureDir).mockResolvedValue(undefined);
     vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+    vi.mocked(fs.writeJson).mockResolvedValue(undefined);
+    vi.mocked(fs.readJson).mockResolvedValue({});
     vi.mocked(getAvailableTemplates).mockResolvedValue(['event-planner', 'chatbot', 'data-analysis']);
     vi.mocked(cloneTemplate).mockResolvedValue(undefined);
     vi.mocked(cloneTemplateLocal).mockResolvedValue(undefined);

package/dist/index.js

@@ -14,6 +14,7 @@ program
     .option('--local-agents-prefix <local-agents-prefix>', 'Local prefix for create-agents-template')
     .option('--local-templates-prefix <local-templates-prefix>', 'Local prefix for project templates')
     .option('--skip-inkeep-cli', 'Skip installing Inkeep CLI globally')
+    .option('--skip-inkeep-mcp', 'Skip installing Inkeep MCP server')
     .parse();
 async function main() {
     const options = program.opts();
@@ -29,6 +30,7 @@ async function main() {
             localAgentsPrefix: options.localAgentsPrefix,
             localTemplatesPrefix: options.localTemplatesPrefix,
             skipInkeepCli: options.skipInkeepCli,
+            skipInkeepMcp: options.skipInkeepMcp,
         });
     }
     catch (error) {

package/dist/utils.d.ts

@@ -43,5 +43,7 @@ export declare const createAgents: (args?: {
     localAgentsPrefix?: string;
     localTemplatesPrefix?: string;
     skipInkeepCli?: boolean;
+    skipInkeepMcp?: boolean;
 }) => Promise<void>;
 export declare function createCommand(dirName?: string, options?: any): Promise<void>;
+export declare function addInkeepMcp(): Promise<void>;

package/dist/utils.js

@@ -1,5 +1,6 @@
 import { exec } from 'node:child_process';
 import crypto from 'node:crypto';
+import os from 'node:os';
 import path from 'node:path';
 import { promisify } from 'node:util';
 import * as p from '@clack/prompts';
@@ -67,7 +68,7 @@ export const defaultAnthropicModelConfigurations = {
     },
 };
 export const createAgents = async (args = {}) => {
-    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, skipInkeepCli, } = args;
+    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, skipInkeepCli, skipInkeepMcp, } = args;
     console.log('skipInkeepCli', skipInkeepCli);
     const tenantId = 'default';
     let projectId;
@@ -257,12 +258,32 @@ export const createAgents = async (args = {}) => {
         await checkPortsAvailability();
         s.stop();
         if (!skipInkeepCli) {
-            const installInkeepCLIResponse = await p.confirm({
-                message: 'Would you like to install the Inkeep CLI globally?',
-            });
-            if (!p.isCancel(installInkeepCLIResponse) && installInkeepCLIResponse) {
-                await installInkeepCLIGlobally();
+            let isGloballyInstalled = false;
+            try {
+                const { stdout } = await execAsync('pnpm list -g @inkeep/agents-cli --json');
+                const result = JSON.parse(stdout);
+                isGloballyInstalled = result?.[0]?.dependencies?.['@inkeep/agents-cli'] !== undefined;
+            }
+            catch (_error) {
+                try {
+                    await execAsync('npm list -g @inkeep/agents-cli');
+                    isGloballyInstalled = true;
+                }
+                catch (_npmError) {
+                    isGloballyInstalled = false;
+                }
             }
+            if (!isGloballyInstalled) {
+                const installInkeepCLIResponse = await p.confirm({
+                    message: 'Would you like to install the Inkeep CLI globally?',
+                });
+                if (!p.isCancel(installInkeepCLIResponse) && installInkeepCLIResponse) {
+                    await installInkeepCLIGlobally();
+                }
+            }
+        }
+        if (!skipInkeepMcp) {
+            await addInkeepMcp();
         }
         p.note(`${color.green('✓')} Workspace created at: ${color.cyan(directoryPath)}\n\n` +
             `${color.yellow('Next steps:')}\n` +
@@ -290,6 +311,7 @@ async function createWorkspaceStructure() {
 async function createEnvironmentFiles(config) {
     // Convert to forward slashes for cross-platform SQLite URI compatibility
     const jwtSigningSecret = crypto.randomBytes(32).toString('hex');
+    const betterAuthSecret = crypto.randomBytes(32).toString('hex');
     const envContent = `# Environment
 ENVIRONMENT=development
 
@@ -326,6 +348,13 @@ INKEEP_AGENTS_JWT_SIGNING_SECRET=${jwtSigningSecret}
 
 # initial project information
 DEFAULT_PROJECT_ID=${config.projectId}
+
+# Auth Configuration
+# INKEEP_AGENTS_MANAGE_UI_USERNAME=admin@example.com
+# INKEEP_AGENTS_MANAGE_UI_PASSWORD=adminADMIN!@12
+BETTER_AUTH_SECRET=${betterAuthSecret}
+DISABLE_AUTH=true
+
 `;
     await fs.writeFile('.env', envContent);
 }
@@ -491,3 +520,126 @@ export async function createCommand(dirName, options) {
         ...options,
     });
 }
+export async function addInkeepMcp() {
+    const editorChoice = await p.select({
+        message: 'Give your IDE access to Inkeep docs and types? (Adds Inkeep MCP)',
+        options: [
+            { value: 'cursor-project', label: 'Cursor (project only)' },
+            { value: 'cursor-global', label: 'Cursor (global, all projects)' },
+            { value: 'windsurf', label: 'Windsurf' },
+            { value: 'vscode', label: 'VSCode' },
+        ],
+        initialValue: 'cursor-project',
+    });
+    if (p.isCancel(editorChoice)) {
+        return;
+    }
+    if (!editorChoice) {
+        return;
+    }
+    const s = p.spinner();
+    try {
+        const mcpConfig = {
+            mcpServers: {
+                inkeep: {
+                    type: 'mcp',
+                    url: 'https://agents.inkeep.com/mcp',
+                },
+            },
+        };
+        const homeDir = os.homedir();
+        switch (editorChoice) {
+            case 'cursor-project': {
+                s.start('Adding Inkeep MCP to Cursor (project)...');
+                const cursorDir = path.join(process.cwd(), '.cursor');
+                const configPath = path.join(cursorDir, 'mcp.json');
+                await fs.ensureDir(cursorDir);
+                let existingConfig = {};
+                if (await fs.pathExists(configPath)) {
+                    existingConfig = await fs.readJson(configPath);
+                }
+                const mergedConfig = {
+                    ...existingConfig,
+                    mcpServers: {
+                        ...existingConfig.mcpServers,
+                        ...mcpConfig.mcpServers,
+                    },
+                };
+                await fs.writeJson(configPath, mergedConfig, { spaces: 2 });
+                s.stop(`${color.green('✓')} Inkeep MCP added to .cursor/mcp.json`);
+                break;
+            }
+            case 'cursor-global': {
+                s.start('Adding Inkeep MCP to Cursor (global)...');
+                const configPath = path.join(homeDir, '.cursor', 'mcp.json');
+                await fs.ensureDir(path.dirname(configPath));
+                let existingConfig = {};
+                if (await fs.pathExists(configPath)) {
+                    existingConfig = await fs.readJson(configPath);
+                }
+                const mergedConfig = {
+                    ...existingConfig,
+                    mcpServers: {
+                        ...existingConfig.mcpServers,
+                        ...mcpConfig.mcpServers,
+                    },
+                };
+                await fs.writeJson(configPath, mergedConfig, { spaces: 2 });
+                s.stop(`${color.green('✓')} Inkeep MCP added to global Cursor settings`);
+                break;
+            }
+            case 'windsurf': {
+                s.start('Adding Inkeep MCP to Windsurf...');
+                const configPath = path.join(homeDir, '.codeium', 'windsurf', 'mcp_config.json');
+                await fs.ensureDir(path.dirname(configPath));
+                let existingConfig = {};
+                if (await fs.pathExists(configPath)) {
+                    existingConfig = await fs.readJson(configPath);
+                }
+                const mergedConfig = {
+                    ...existingConfig,
+                    mcpServers: {
+                        ...existingConfig.mcpServers,
+                        ...mcpConfig.mcpServers,
+                    },
+                };
+                await fs.writeJson(configPath, mergedConfig, { spaces: 2 });
+                s.stop(`${color.green('✓')} Inkeep MCP added to Windsurf settings`);
+                break;
+            }
+            case 'vscode': {
+                s.start('Adding Inkeep MCP to VSCode...');
+                let configPath;
+                if (process.platform === 'darwin') {
+                    configPath = path.join(homeDir, 'Library', 'Application Support', 'Code', 'User', 'mcp.json');
+                }
+                else if (process.platform === 'win32') {
+                    configPath = path.join(homeDir, 'AppData', 'Roaming', 'Code', 'User', 'mcp.json');
+                }
+                else {
+                    configPath = path.join(homeDir, '.config', 'Code', 'User', 'mcp.json');
+                }
+                await fs.ensureDir(path.dirname(configPath));
+                let existingConfig = {};
+                if (await fs.pathExists(configPath)) {
+                    existingConfig = await fs.readJson(configPath);
+                }
+                const mergedConfig = {
+                    ...existingConfig,
+                    servers: {
+                        ...existingConfig.servers,
+                        ...mcpConfig.mcpServers,
+                    },
+                };
+                await fs.writeJson(configPath, mergedConfig, { spaces: 2 });
+                s.stop(`${color.green('✓')} Inkeep MCP added to VSCode settings\n\n${color.yellow('Next steps:')}\n` +
+                    `  start the MCP by going to ${configPath} and clicking start`);
+                break;
+            }
+        }
+    }
+    catch (error) {
+        s.stop();
+        console.error(`${color.yellow('⚠')}  Could not automatically configure MCP server: ${error}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "Create an Inkeep Agent Framework project",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "drizzle-kit": "^0.31.5",
     "fs-extra": "^11.0.0",
     "picocolors": "^1.0.0",
-    "@inkeep/agents-core": "0.34.0"
+    "@inkeep/agents-core": "0.35.0"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",