@mrpatronz/nexusflow 0.2.11 → 0.2.13

package/src/commands/open.ts

@@ -5,7 +5,7 @@
 
 import chalk from 'chalk';
 import { execa } from 'execa';
-import { select, confirm } from '@inquirer/prompts';
+import { select, confirm, search } from '@inquirer/prompts';
 
 import { loadConfig } from '../core/config.js';
 import { listWorkspaces } from '../core/workspace.js';
@@ -29,12 +29,20 @@ export async function openCommand(): Promise<void> {
   console.log(chalk.bold.cyan('\n📂 Open Workspace\n'));
 
   // Let user pick a workspace
-  const selected = await select({
-    message: 'Select a workspace to open:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos, ${ws.assistants.join(', ')})`)}`,
-      value: ws.workspacePath,
-    })),
+  const selected = await search({
+    message: 'Search and select a workspace to open:',
+    source: async (input) => {
+      const query = (input || '').toLowerCase();
+      const filtered = workspaces.filter(
+        (ws) =>
+          ws.branchName.toLowerCase().includes(query) ||
+          ws.workspacePath.toLowerCase().includes(query)
+      );
+      return filtered.map((ws) => ({
+        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos, ${ws.assistants.join(', ')})`)}`,
+        value: ws.workspacePath,
+      }));
+    },
   });
 
   // Let user pick an editor
@@ -43,7 +51,10 @@ export async function openCommand(): Promise<void> {
 
   if (editor) {
     try {
-      await execa(editor.command, [selected], { stdio: 'ignore' });
+      await execa(editor.command, [selected], {
+        stdio: 'ignore',
+        shell: process.platform === 'win32',
+      });
       console.log(chalk.green(`\n✅ Opened ${selected} in ${editor.name}\n`));
     } catch {
       console.log(chalk.yellow(`\n⚠️  Could not open editor. Navigate manually:`));
@@ -101,7 +112,11 @@ export async function openCommand(): Promise<void> {
       }
 
       try {
-        await execa(cmdName, cmdArgs, { cwd: selected, stdio: 'inherit' });
+        await execa(cmdName, cmdArgs, {
+          cwd: selected,
+          stdio: 'inherit',
+          shell: process.platform === 'win32',
+        });
         console.log(chalk.green(`\n👋 Exited ${assistant} session.`));
       } catch {
         const fullCmd = [cmdName, ...cmdArgs].join(' ');

package/src/commands/pack.ts

@@ -51,7 +51,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
   }
 
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   const config = await loadConfig();
   const workspaces = await listWorkspaces(config.workspacesDir);

package/src/commands/refresh.ts

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { select } from '@inquirer/prompts';
+import { select, search } from '@inquirer/prompts';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 
@@ -117,7 +117,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
   }
 
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   const config = await loadConfig();
   const workspaces = await listWorkspaces(config.workspacesDir);
@@ -127,12 +127,20 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
     return null;
   }
 
-  const selected = await select({
-    message: 'Select a workspace to refresh:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-      value: ws.workspacePath,
-    })),
+  const selected = await search({
+    message: 'Search and select a workspace to refresh:',
+    source: async (input) => {
+      const query = (input || '').toLowerCase();
+      const filtered = workspaces.filter(
+        (ws) =>
+          ws.branchName.toLowerCase().includes(query) ||
+          ws.workspacePath.toLowerCase().includes(query)
+      );
+      return filtered.map((ws) => ({
+        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
+        value: ws.workspacePath,
+      }));
+    },
   });
 
   return selected;

package/src/commands/remove.ts

@@ -5,7 +5,7 @@
 
 import chalk from 'chalk';
 import ora from 'ora';
-import { select, confirm } from '@inquirer/prompts';
+import { select, confirm, search } from '@inquirer/prompts';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 
@@ -52,12 +52,20 @@ export async function removeCommand(workspaceArg?: string): Promise<void> {
       return;
     }
 
-    const selected = await select({
-      message: 'Select a workspace to delete:',
-      choices: workspaces.map((ws) => ({
-        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-        value: ws,
-      })),
+    const selected = await search({
+      message: 'Search and select a workspace to delete:',
+      source: async (input) => {
+        const query = (input || '').toLowerCase();
+        const filtered = workspaces.filter(
+          (ws) =>
+            ws.branchName.toLowerCase().includes(query) ||
+            ws.workspacePath.toLowerCase().includes(query)
+        );
+        return filtered.map((ws) => ({
+          name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
+          value: ws,
+        }));
+      },
     });
 
     workspacePath = selected.workspacePath;

package/src/commands/start.ts

@@ -93,7 +93,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
 
   // Check if CWD is a workspace
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   // Otherwise, list workspaces and let user pick
   const config = await loadConfig();

package/src/commands/status.ts

@@ -32,7 +32,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
   if (workspaceArg) return workspaceArg;
 
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   const config = await loadConfig();
   const workspaces = await listWorkspaces(config.workspacesDir);

package/src/commands/stop.ts

@@ -33,7 +33,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
   if (workspaceArg) return workspaceArg;
 
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   const config = await loadConfig();
   const workspaces = await listWorkspaces(config.workspacesDir);

package/src/commands/sync.ts

@@ -4,7 +4,7 @@
  */
 
 import chalk from 'chalk';
-import { select } from '@inquirer/prompts';
+import { select, search } from '@inquirer/prompts';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
 
@@ -123,7 +123,7 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
   }
 
   const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return process.cwd();
+  if (cwdFeature) return cwdFeature.workspacePath;
 
   const config = await loadConfig();
   const workspaces = await listWorkspaces(config.workspacesDir);
@@ -133,12 +133,20 @@ async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
     return null;
   }
 
-  const selected = await select({
-    message: 'Select a workspace to sync:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-      value: ws.workspacePath,
-    })),
+  const selected = await search({
+    message: 'Search and select a workspace to sync:',
+    source: async (input) => {
+      const query = (input || '').toLowerCase();
+      const filtered = workspaces.filter(
+        (ws) =>
+          ws.branchName.toLowerCase().includes(query) ||
+          ws.workspacePath.toLowerCase().includes(query)
+      );
+      return filtered.map((ws) => ({
+        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
+        value: ws.workspacePath,
+      }));
+    },
   });
 
   return selected;

package/src/core/workspace.ts

@@ -82,6 +82,27 @@ export async function createWorkspace(
     console.warn('Warning: Failed to create .vscode/settings.json:', error);
   }
 
+  // Create .cursor/mcp.json for workspace-local Cursor MCP configuration
+  try {
+    const cursorDir = path.join(workspacePath, '.cursor');
+    await fs.mkdir(cursorDir, { recursive: true });
+    const cursorMcp = {
+      "mcpServers": {
+        "nexusflow": {
+          "command": "npx",
+          "args": ["-y", "@mrpatronz/nexusflow", "mcp", "run", workspacePath]
+        }
+      }
+    };
+    await fs.writeFile(
+      path.join(cursorDir, 'mcp.json'),
+      JSON.stringify(cursorMcp, null, 2) + '\n',
+      'utf-8'
+    );
+  } catch (error) {
+    console.warn('Warning: Failed to create .cursor/mcp.json:', error);
+  }
+
   // Create a worktree for each repo inside the workspace.
   for (const repo of repos) {
     const worktreeTarget = path.join(workspacePath, repo.name);
@@ -173,8 +194,10 @@ export async function saveFeatureConfig(
 export async function loadFeatureConfig(
   workspacePath: string,
 ): Promise<Feature | null> {
-  const manifestPath = path.join(workspacePath, MANIFEST_FILE);
+  const rootDir = await findWorkspaceRoot(workspacePath);
+  if (!rootDir) return null;
 
+  const manifestPath = path.join(rootDir, MANIFEST_FILE);
   try {
     const raw = await fs.readFile(manifestPath, 'utf-8');
     return JSON.parse(raw) as Feature;
@@ -183,6 +206,30 @@ export async function loadFeatureConfig(
   }
 }
 
+/**
+ * Traverses up parent directories to find a directory containing `nexusflow.json`.
+ *
+ * @param startPath - Path to start searching from.
+ * @returns Absolute path to the workspace root directory, or null if not found.
+ */
+export async function findWorkspaceRoot(startPath: string): Promise<string | null> {
+  let current = path.resolve(startPath);
+  while (true) {
+    const manifestPath = path.join(current, MANIFEST_FILE);
+    try {
+      await fs.access(manifestPath);
+      return current;
+    } catch {
+      const parent = path.dirname(current);
+      if (parent === current) {
+        break; // Reached root directory
+      }
+      current = parent;
+    }
+  }
+  return null;
+}
+
 /**
  * Resolves a repo path to a full RepoInfo object.
  *

package/src/generators/antigravity.ts

@@ -0,0 +1,32 @@
+/**
+ * @module generators/antigravity
+ * Generates an AGENTS.md file for Antigravity.
+ */
+
+import path from 'node:path';
+import fse from 'fs-extra';
+import type { WorkspaceContext } from '../types.js';
+import { buildContextContent } from './base.js';
+
+/**
+ * Generates an `AGENTS.md` file at the workspace root.
+ *
+ * Antigravity reads this file for persistent context about the workspace.
+ *
+ * @param ctx           - The workspace context (feature + repos + analysis).
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export async function generateAntigravityConfig(
+  ctx: WorkspaceContext,
+  workspacePath: string,
+): Promise<void> {
+  const content = buildContextContent(ctx);
+  const filePath = path.join(workspacePath, 'AGENTS.md');
+
+  try {
+    await fse.writeFile(filePath, content, 'utf-8');
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to write AGENTS.md: ${message}`);
+  }
+}

package/src/generators/index.ts

@@ -3,6 +3,7 @@ import path from 'node:path';
 import fse from 'fs-extra';
 import type { AIAssistant, WorkspaceContext } from '../types.js';
 import { generateClaudeConfig } from './claude.js';
+import { generateAntigravityConfig } from './antigravity.js';
 import { generateCodexConfig } from './codex.js';
 import { generateCopilotConfig } from './copilot.js';
 import { generateCursorConfig } from './cursor.js';
@@ -19,7 +20,7 @@ const GENERATORS: Record<
   }
 > = {
   claude: { generate: generateClaudeConfig, outputFile: 'CLAUDE.md' },
-  antigravity: { generate: generateClaudeConfig, outputFile: 'CLAUDE.md' },
+  antigravity: { generate: generateAntigravityConfig, outputFile: 'AGENTS.md' },
   codex: { generate: generateCodexConfig, outputFile: 'AGENTS.md' },
   copilot: { generate: generateCopilotConfig, outputFile: '.github/copilot-instructions.md' },
   cursor: { generate: generateCursorConfig, outputFile: '.cursor/rules/nexusflow.mdc' },
@@ -177,6 +178,7 @@ export async function generateContextFiles(
     }
   }
 
+  // Generate configuration for each selected assistant
   for (const assistant of assistants) {
     const entry = GENERATORS[assistant];
 
@@ -195,6 +197,25 @@ export async function generateContextFiles(
     }
   }
 
+  // Ensure AGENTS.md is always generated if it is not already generated as a primary assistant file,
+  // since it is the universal standard for AI coding agents.
+  const hasAgentsGen = assistants.includes('antigravity') || assistants.includes('codex');
+  if (!hasAgentsGen) {
+    try {
+      await generateAntigravityConfig(ctx, workspacePath);
+      console.log(
+        chalk.green('  ✔'),
+        `Generated fallback ${chalk.bold('AGENTS.md')} for harness context`,
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(
+        chalk.red('  ✖'),
+        `Failed to generate fallback AGENTS.md: ${message}`,
+      );
+    }
+  }
+
 
   // Generate implementation plan from dependency analysis (if analysis data available)
   try {
@@ -221,6 +242,7 @@ export async function generateContextFiles(
 
 // Re-export individual generators for direct use
 export { generateClaudeConfig } from './claude.js';
+export { generateAntigravityConfig } from './antigravity.js';
 export { generateCodexConfig } from './codex.js';
 export { generateCopilotConfig } from './copilot.js';
 export { generateCursorConfig } from './cursor.js';

package/src/generators/skills-generator.ts

@@ -175,10 +175,14 @@ async function deploySkill(
   };
   const title = titleMap[skillName] || skillName;
 
-  if (assistant === 'claude' || assistant === 'antigravity') {
+  if (assistant === 'claude') {
     const skillDir = path.join(workspacePath, '.claude', 'skills', skillName);
     await fse.ensureDir(skillDir);
     await fse.writeFile(path.join(skillDir, 'SKILL.md'), content, 'utf-8');
+  } else if (assistant === 'antigravity') {
+    const skillDir = path.join(workspacePath, '.agents', 'skills', skillName);
+    await fse.ensureDir(skillDir);
+    await fse.writeFile(path.join(skillDir, 'SKILL.md'), content, 'utf-8');
   } else if (assistant === 'cursor') {
     const ruleDir = path.join(workspacePath, '.cursor', 'rules');
     await fse.ensureDir(ruleDir);