@inkeep/create-agents 0.33.2 → 0.34.1

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

@@ -32,6 +32,8 @@ describe('create-agents quickstart e2e', () => {
             createAgentsPrefix,
             '--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

@@ -13,6 +13,8 @@ program
     .option('--disable-git', 'Disable git initialization')
     .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();
@@ -27,6 +29,8 @@ async function main() {
             disableGit: options.disableGit,
             localAgentsPrefix: options.localAgentsPrefix,
             localTemplatesPrefix: options.localTemplatesPrefix,
+            skipInkeepCli: options.skipInkeepCli,
+            skipInkeepMcp: options.skipInkeepMcp,
         });
     }
     catch (error) {

package/dist/templates.js

@@ -261,6 +261,18 @@ export async function getAvailableTemplates(localPrefix) {
     }
     // Fetch the list of templates from your repo
     const response = await fetch(`https://api.github.com/repos/inkeep/agents/contents/agents-cookbook/template-projects`);
-    const contents = await response.json();
+    if (!response.ok) {
+        throw new Error(`Failed to fetch templates. Please check your internet connection and try again.`);
+    }
+    let contents;
+    try {
+        contents = await response.json();
+    }
+    catch (error) {
+        throw new Error(`Failed to parse templates response. Please check your internet connection and try again. ${error}`);
+    }
+    if (!Array.isArray(contents)) {
+        throw new Error('Unexpected response format from templates. Please check your internet connection and try again');
+    }
     return contents.filter((item) => item.type === 'dir').map((item) => item.name);
 }

package/dist/utils.d.ts

@@ -42,5 +42,8 @@ export declare const createAgents: (args?: {
     disableGit?: boolean;
     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,8 @@ export const defaultAnthropicModelConfigurations = {
     },
 };
 export const createAgents = async (args = {}) => {
-    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, } = args;
+    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, skipInkeepCli, skipInkeepMcp, } = args;
+    console.log('skipInkeepCli', skipInkeepCli);
     const tenantId = 'default';
     let projectId;
     let templateName;
@@ -255,6 +257,17 @@ 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();
+            }
+        }
+        if (!skipInkeepMcp) {
+            await addInkeepMcp();
+        }
         p.note(`${color.green('✓')} Workspace created at: ${color.cyan(directoryPath)}\n\n` +
             `${color.yellow('Next steps:')}\n` +
             `  cd ${dirName}\n` +
@@ -348,6 +361,30 @@ export const myProject = project({
         await fs.writeFile(`src/projects/${config.projectId}/index.ts`, customIndexContent);
     }
 }
+async function installInkeepCLIGlobally() {
+    const s = p.spinner();
+    s.start('Installing Inkeep CLI globally with pnpm...');
+    try {
+        await execAsync('pnpm add -g @inkeep/agents-cli');
+        s.stop('✓ Inkeep CLI installed successfully with pnpm');
+        return;
+    }
+    catch (_pnpmError) {
+        s.message('pnpm failed, trying npm...');
+        try {
+            await execAsync('npm install -g @inkeep/agents-cli');
+            s.stop('✓ Inkeep CLI installed successfully with npm');
+            return;
+        }
+        catch (_npmError) {
+            s.stop('⚠️  Could not automatically install Inkeep CLI globally');
+            console.warn('You can install it manually later by running:');
+            console.warn('  npm install -g @inkeep/agents-cli');
+            console.warn('  or');
+            console.warn('  pnpm add -g @inkeep/agents-cli\n');
+        }
+    }
+}
 async function installDependencies() {
     try {
         const { stderr } = await execAsync('pnpm install');
@@ -458,3 +495,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.33.2",
+  "version": "0.34.1",
   "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.33.2"
+    "@inkeep/agents-core": "0.34.1"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",