@nemus-cli/nemus 0.9.0 → 0.11.0

package/skills/prune-workspaces.md

@@ -0,0 +1,23 @@
+---
+name: prune-workspaces
+description: Bulk-delete workspaces with no recent activity, safe by default (protects uncommitted/unpushed work)
+---
+
+Preview first — never delete without showing the user the plan:
+```bash
+nemus prune --days 30 --dry-run
+```
+
+Then prune after confirming with the user:
+```bash
+nemus prune --days 30          # prompts (default: No)
+nemus prune --days 30 --yes    # non-interactive — only when the user is sure
+```
+
+- **Stale** = no agent session (or, failing that, no `createdAt`) in the last N
+  days (`--days`, default 30). Undatable workspaces are never selected.
+- **Safe by default:** workspaces with uncommitted or unpushed changes are
+  **protected** and listed with the reason — not deleted. `--include-dirty`
+  overrides this (only with explicit user consent to lose that work).
+- `--json` and `--dry-run` never delete.
+- Deletion is permanent — repos must be re-cloned. Always confirm first.

package/skills/reflect.md

@@ -0,0 +1,21 @@
+---
+name: reflect
+description: Retrospective on recent agent sessions — get concrete tips to improve skills, context, and prompts
+---
+
+Analyze recent workspaces' agent sessions and get setup improvement tips (read-only; changes no repos):
+```bash
+nemus reflect                     # most recent workspaces (default 10)
+nemus reflect --workspace <name>  # a single workspace
+nemus reflect --markdown > reflection.md   # shareable report
+```
+
+Review saved reports (saved under `~/.nemus/reflect/` unless `--no-save`):
+```bash
+nemus reflect history      # list past reports
+nemus reflect show [id]    # show one (defaults to latest)
+```
+
+- Uses *your own* configured agent (claude/pi/opencode) as the judge — no API key of Nemus's.
+- `--json` / `--markdown` for machine or shareable output; `--group-by kind|priority`.
+- Safe: it reads transcripts and prints advice, nothing is modified.

package/src/commands/analyze-deps.ts

@@ -11,7 +11,7 @@ import {
 import { logError, logInfo, logStep, logSuccess } from '../utils/logger';
 import { outputJson, outputJsonError } from '../utils/output';
 import { colorize } from '../utils/colors';
-import inquirer from 'inquirer';
+import { confirm } from '../utils/prompt';
 import { resolveWorkspace } from '../utils/command-helpers';
 
 const displayDependencyAnalysis = (analyses: Map<string, any>) => {
@@ -122,14 +122,10 @@ async function handleAnalyzeDeps(workspaceArg?: string, opts: { json?: boolean }
     }
 
     if (process.stdout.isTTY) {
-      const { saveToMetadata } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'saveToMetadata',
-          message: 'Save dependency analysis to workspace metadata?',
-          default: true,
-        },
-      ]);
+      const saveToMetadata = await confirm({
+        message: 'Save dependency analysis to workspace metadata?',
+        default: true,
+      });
 
       if (saveToMetadata) {
         const updatedMetadata = updateWorkspaceMetadata(metadata, analyses);

package/src/commands/archive.ts

@@ -3,7 +3,7 @@ import { listWorkspaces, archiveWorkspace, unarchiveWorkspace } from '../utils/w
 import { promptMultiWorkspaceSelection } from '../utils/prompts';
 import { logInfo, logSuccess, logError } from '../utils/logger';
 import { colorize } from '../utils/colors';
-import inquirer from 'inquirer';
+import { confirm } from '../utils/prompt';
 import { getGlobalOpts, parseList } from '../utils/command-helpers';
 
 export function registerArchiveCommand(parent: Command) {
@@ -50,13 +50,12 @@ async function handleArchive(opts: {
       }
 
       if (!opts.yes) {
-        const { confirmed } = await inquirer.prompt([{
-          type: 'confirm', name: 'confirmed',
+        const confirmed = await confirm({
           message: selectedNames.length === 1
             ? `Unarchive workspace ${selectedNames[0]}?`
             : `Unarchive these ${selectedNames.length} workspaces?`,
           default: true,
-        }]);
+        });
         if (!confirmed) return;
       }
 
@@ -86,13 +85,12 @@ async function handleArchive(opts: {
       }
 
       if (!opts.yes) {
-        const { confirmed } = await inquirer.prompt([{
-          type: 'confirm', name: 'confirmed',
+        const confirmed = await confirm({
           message: selectedNames.length === 1
             ? `Archive workspace ${selectedNames[0]}? It will be auto-deleted in 30 days.`
             : `Archive these ${selectedNames.length} workspaces? They will be auto-deleted in 30 days.`,
           default: true,
-        }]);
+        });
         if (!confirmed) return;
       }
 

package/src/commands/branch/create.ts

@@ -6,7 +6,7 @@ import { createBranch } from '../../utils/branch-operations';
 import { logError, logInfo, logStep, logSuccess, logWarning } from '../../utils/logger';
 import { colorize } from '../../utils/colors';
 import { WORKSPACES_DIR } from '../../utils/config';
-import inquirer from 'inquirer';
+import { input } from '../../utils/prompt';
 
 export interface BranchCreateOpts {
   workspace?: string;
@@ -40,14 +40,10 @@ export const main = async (opts?: BranchCreateOpts) => {
         logError('Usage: w branch create --workspace <name> --branch <branch>');
         process.exit(1);
       }
-      const { branch } = await inquirer.prompt([
-        {
-          type: 'input',
-          name: 'branch',
-          message: 'New branch name:',
-          validate: (input: string) => input.trim() ? true : 'Branch name cannot be empty',
-        },
-      ]);
+      const branch = await input({
+        message: 'New branch name:',
+        validate: (input: string) => input.trim() ? true : 'Branch name cannot be empty',
+      });
       branchName = branch;
     }
 

package/src/commands/branch/switch.ts

@@ -7,7 +7,7 @@ import { promptWorkspaceSelection } from '../../utils/prompts';
 import { logInfo, logSuccess, logError, logWarning } from '../../utils/logger';
 import { colorize } from '../../utils/colors';
 import { switchBranch, BranchSwitchResult } from '../../utils/branch-operations';
-import inquirer from 'inquirer';
+import { confirm, input } from '../../utils/prompt';
 
 export interface BranchSwitchOpts {
   workspace?: string;
@@ -61,20 +61,16 @@ export async function main(opts?: BranchSwitchOpts) {
         logError('Usage: w branch switch --workspace <name> --branch <branch>');
         process.exit(1);
       }
-      const { branch } = await inquirer.prompt([
-        {
-          type: 'input',
-          name: 'branch',
-          message: 'Target branch name:',
-          default: 'main',
-          validate: (input: string) => {
-            if (!input || input.trim().length === 0) {
-              return 'Branch name cannot be empty';
-            }
-            return true;
-          },
+      const branch = await input({
+        message: 'Target branch name:',
+        default: 'main',
+        validate: (input: string) => {
+          if (!input || input.trim().length === 0) {
+            return 'Branch name cannot be empty';
+          }
+          return true;
         },
-      ]);
+      });
       targetBranch = branch;
     }
 
@@ -82,14 +78,10 @@ export async function main(opts?: BranchSwitchOpts) {
 
     // Skip confirmation when --yes flag is provided
     if (!yes && process.stdout.isTTY) {
-      const { confirmed } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'confirmed',
-          message: 'Proceed with bulk branch switch?',
-          default: true,
-        },
-      ]);
+      const confirmed = await confirm({
+        message: 'Proceed with bulk branch switch?',
+        default: true,
+      });
 
       if (!confirmed) {
         logInfo('Branch switch cancelled');

package/src/commands/cache/manager.ts

@@ -4,7 +4,7 @@ import { clearCache, getCacheStats } from '../../utils/cache';
 import { fetchOrgRepos, verifyGhAuth, displayAuthInstructions } from '../../utils/github';
 import { logInfo, logSuccess, logError } from '../../utils/logger';
 import { colorize } from '../../utils/colors';
-import inquirer from 'inquirer';
+import { confirm, select } from '../../utils/prompt';
 import * as fuzzy from 'fuzzy';
 
 export async function cacheInfo() {
@@ -123,32 +123,24 @@ export async function main() {
     }
 
     // Interactive mode (original behavior)
-    const { selectedAction } = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'selectedAction',
-        message: 'Select action:',
-        choices: [
-          { name: 'View cache info', value: 'info' },
-          { name: 'Refresh cache (force fetch from GitHub)', value: 'refresh' },
-          { name: 'Clear cache', value: 'clear' },
-        ],
-      },
-    ]);
+    const selectedAction = await select({
+      message: 'Select action:',
+      choices: [
+        { name: 'View cache info', value: 'info' },
+        { name: 'Refresh cache (force fetch from GitHub)', value: 'refresh' },
+        { name: 'Clear cache', value: 'clear' },
+      ],
+    });
 
     if (selectedAction === 'info') {
       await cacheInfo();
     } else if (selectedAction === 'refresh') {
       await cacheRefresh();
     } else if (selectedAction === 'clear') {
-      const { confirmed } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'confirmed',
-          message: 'Are you sure you want to clear the cache?',
-          default: false,
-        },
-      ]);
+      const confirmed = await confirm({
+        message: 'Are you sure you want to clear the cache?',
+        default: false,
+      });
 
       if (confirmed) {
         await cacheClear();

package/src/commands/cleanup.ts

@@ -5,7 +5,7 @@ import { loadMetadata } from '../utils/workspace-meta';
 import { removeNodeModules, removeBuildArtifacts, gitClean } from '../utils/cleanup-operations';
 import { logError, logInfo, logStep, logSuccess } from '../utils/logger';
 import { colorize } from '../utils/colors';
-import inquirer from 'inquirer';
+import { checkbox, confirm } from '../utils/prompt';
 import { getGlobalOpts, resolveWorkspace } from '../utils/command-helpers';
 
 export function registerCleanupCommand(parent: Command) {
@@ -54,19 +54,14 @@ async function handleCleanup(workspaceArg: string | undefined, opts: {
       if (build) operations.push('build');
       if (gitCleanFlag) operations.push('git_clean');
     } else {
-      const result = await inquirer.prompt([
-        {
-          type: 'checkbox',
-          name: 'operations',
-          message: 'Select cleanup operations:',
-          choices: [
-            { name: 'Remove node_modules (all repos)', value: 'node_modules' },
-            { name: 'Remove build artifacts (dist, build, .next, coverage)', value: 'build' },
-            { name: 'Git clean (remove untracked files)', value: 'git_clean' },
-          ],
-        },
-      ]);
-      operations = result.operations;
+      operations = await checkbox({
+        message: 'Select cleanup operations:',
+        choices: [
+          { name: 'Remove node_modules (all repos)', value: 'node_modules' },
+          { name: 'Remove build artifacts (dist, build, .next, coverage)', value: 'build' },
+          { name: 'Git clean (remove untracked files)', value: 'git_clean' },
+        ],
+      });
     }
 
     if (operations.length === 0) {
@@ -75,16 +70,12 @@ async function handleCleanup(workspaceArg: string | undefined, opts: {
     }
 
     if (!opts.yes) {
-      const { confirm } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'confirm',
-          message: `Proceed with cleanup? This cannot be undone.`,
-          default: false,
-        },
-      ]);
+      const confirmed = await confirm({
+        message: `Proceed with cleanup? This cannot be undone.`,
+        default: false,
+      });
 
-      if (!confirm) {
+      if (!confirmed) {
         logInfo('Cleanup cancelled');
         return;
       }

package/src/commands/configure-claude.ts

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { loadClaudeConfig, saveClaudeConfig } from '../utils/claude-integration';
 import { logSuccess, logError } from '../utils/logger';
 import { colorize } from '../utils/colors';
-import inquirer from 'inquirer';
+import { confirm } from '../utils/prompt';
 
 export function registerConfigureClaudeCommand(parent: Command) {
   parent
@@ -27,10 +27,9 @@ async function handleConfigureClaude() {
     console.log(`  Generate context: ${currentConfig.generateContext ? colorize('Enabled', 'green') : colorize('Disabled', 'red')}`);
     console.log('');
 
-    const answers = await inquirer.prompt([
-      { type: 'confirm', name: 'autoLaunch', message: 'Auto-launch Claude Code after workspace creation?', default: currentConfig.autoLaunch },
-      { type: 'confirm', name: 'generateContext', message: 'Generate CLAUDE.md context file in workspaces?', default: currentConfig.generateContext },
-    ]);
+    const autoLaunch = await confirm({ message: 'Auto-launch Claude Code after workspace creation?', default: currentConfig.autoLaunch });
+    const generateContext = await confirm({ message: 'Generate CLAUDE.md context file in workspaces?', default: currentConfig.generateContext });
+    const answers = { autoLaunch, generateContext };
 
     await saveClaudeConfig(answers);
 

package/src/commands/configure.ts

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { execFileSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
-import inquirer from 'inquirer';
+import { input, confirm, select } from '../utils/prompt';
 import { getUserConfig, saveUserConfig, UserConfig } from '../utils/config';
 import { clearCache } from '../utils/cache';
 import { logSuccess, logError, logInfo, logWarning } from '../utils/logger';
@@ -39,40 +39,46 @@ async function handleConfigure() {
   console.log('');
 
   try {
-    const answers = await inquirer.prompt([
-      { type: 'input', name: 'workspacesDir', message: 'Workspaces directory:', default: current.workspacesDir, validate: (val: string) => val.trim().length > 0 || 'Directory path is required' },
-      { type: 'input', name: 'githubOrg', message: 'GitHub organization:', default: current.githubOrg, validate: (val: string) => /^[a-zA-Z0-9_-]+$/.test(val.trim()) || 'Must be a valid GitHub org name' },
-      { type: 'list', name: 'cloneProtocol', message: 'Clone protocol:', choices: [{ name: 'SSH  (git@github.com:...)', value: 'ssh' }, { name: 'HTTPS (https://github.com/...)', value: 'https' }], default: current.cloneProtocol },
-      { type: 'confirm', name: 'autoLaunchClaude', message: 'Auto-launch AI agent after workspace creation?', default: current.autoLaunchClaude },
-      { type: 'confirm', name: 'generateClaudeContext', message: 'Generate context file in workspaces?', default: current.generateClaudeContext },
-      { type: 'confirm', name: 'installMcp', message: 'Install MCP server (Claude Code only)?', default: current.installMcp },
-      { type: 'list', name: 'aiAgent', message: 'AI Agent(s) to integrate with:', choices: [
-        { name: 'Auto-detect (recommended)', value: 'auto' },
-        { name: 'Claude Code only', value: 'claude' },
-        { name: 'Pi only', value: 'pi' },
-        { name: 'OpenCode only', value: 'opencode' },
-        { name: 'All available', value: 'both' },
-      ], default: current.aiAgent },
-      // Only ask about primary agent when aiAgent is 'both' or 'auto'
-      // (when specific agent chosen, primary is implicitly that agent)
-      { type: 'list', name: 'primaryAgent', message: 'Primary agent (used for launching):', choices: [
+    // Sequential modular prompts. The classic `when:` conditions become `if`
+    // guards; a skipped question leaves its answer key undefined, exactly as the
+    // classic API did (downstream code already tolerates that via `??`).
+    const answers: any = {};
+    answers.workspacesDir = await input({ message: 'Workspaces directory:', default: current.workspacesDir, validate: (val: string) => val.trim().length > 0 || 'Directory path is required' });
+    answers.githubOrg = await input({ message: 'GitHub organization:', default: current.githubOrg, validate: (val: string) => /^[a-zA-Z0-9_-]+$/.test(val.trim()) || 'Must be a valid GitHub org name' });
+    answers.cloneProtocol = await select({ message: 'Clone protocol:', choices: [{ name: 'SSH  (git@github.com:...)', value: 'ssh' }, { name: 'HTTPS (https://github.com/...)', value: 'https' }], default: current.cloneProtocol });
+    answers.autoLaunchClaude = await confirm({ message: 'Auto-launch AI agent after workspace creation?', default: current.autoLaunchClaude });
+    answers.generateClaudeContext = await confirm({ message: 'Generate context file in workspaces?', default: current.generateClaudeContext });
+    answers.installMcp = await confirm({ message: 'Install MCP server (Claude Code only)?', default: current.installMcp });
+    answers.aiAgent = await select<string>({ message: 'AI Agent(s) to integrate with:', choices: [
+      { name: 'Auto-detect (recommended)', value: 'auto' },
+      { name: 'Claude Code only', value: 'claude' },
+      { name: 'Pi only', value: 'pi' },
+      { name: 'OpenCode only', value: 'opencode' },
+      { name: 'All available', value: 'both' },
+    ], default: current.aiAgent });
+    // Only ask about primary agent when aiAgent is 'both' or 'auto'
+    // (when specific agent chosen, primary is implicitly that agent)
+    if (answers.aiAgent === 'both' || answers.aiAgent === 'auto') {
+      answers.primaryAgent = await select<string>({ message: 'Primary agent (used for launching):', choices: [
         { name: 'Auto-detect (first available)', value: 'auto' },
         { name: 'Claude Code', value: 'claude' },
         { name: 'Pi', value: 'pi' },
         { name: 'OpenCode', value: 'opencode' },
-      ], default: current.primaryAgent, when: (ans) => ans.aiAgent === 'both' || ans.aiAgent === 'auto' },
-      { type: 'confirm', name: 'piWorkspaceInputStatus',
+      ], default: current.primaryAgent });
+    }
+    if (answers.aiAgent === 'pi' || answers.aiAgent === 'both' || answers.aiAgent === 'auto') {
+      answers.piWorkspaceInputStatus = await confirm({
         message: 'Show workspace status widget in Pi input area (branch, PRs, CI)?',
-        default: current.piWorkspaceInputStatus !== false,
-        when: (ans) => ans.aiAgent === 'pi' || ans.aiAgent === 'both' || ans.aiAgent === 'auto' },
-      { type: 'confirm', name: 'claudeWorkspaceStatusLine',
+        default: current.piWorkspaceInputStatus !== false });
+    }
+    if (answers.aiAgent === 'claude' || answers.aiAgent === 'both' || answers.aiAgent === 'auto') {
+      answers.claudeWorkspaceStatusLine = await confirm({
         message: 'Add workspace repo table to Claude Code status line?',
-        default: current.claudeWorkspaceStatusLine !== false,
-        when: (ans) => ans.aiAgent === 'claude' || ans.aiAgent === 'both' || ans.aiAgent === 'auto' },
-      { type: 'confirm', name: 'autoReportBugs',
-        message: 'Auto-file a GitHub issue when a command crashes? (deduped, sanitized)',
-        default: current.autoReportBugs === true },
-    ]);
+        default: current.claudeWorkspaceStatusLine !== false });
+    }
+    answers.autoReportBugs = await confirm({
+      message: 'Auto-file a GitHub issue when a command crashes? (deduped, sanitized)',
+      default: current.autoReportBugs === true });
 
     // Validate and normalize config
     let primaryAgent = answers.primaryAgent || 'auto';

package/src/commands/dashboard/session-picker.ts

@@ -9,12 +9,9 @@ import { getWorkspaceSessions, WorkspaceSession } from '../../utils/claude-sessi
 import { launchAgentPane } from './launcher';
 import { getAgentPaths, getPrimaryAgent, ConcreteAgentType } from '../../utils/agent-config';
 import { colorize } from '../../utils/colors';
-import inquirer from 'inquirer';
-import autocompletePrompt from 'inquirer-autocomplete-prompt';
+import { search } from '../../utils/prompt';
 import * as fuzzy from 'fuzzy';
 
-inquirer.registerPrompt('autocomplete', autocompletePrompt);
-
 async function main() {
   try {
     const sessions = await getWorkspaceSessions();
@@ -30,12 +27,11 @@ async function main() {
       timeLabel: session.lastActiveLabel,
     }));
 
-    const { selected } = await inquirer.prompt([{
-      type: 'autocomplete',
-      name: 'selected',
+    const selected = await search<typeof items[number]>({
       message: 'Select session to resume:',
-      source: async (_answersSoFar: any, input: string | undefined) => {
-        const searchInput = input || '';
+      pageSize: 15,
+      source: async (term: string | undefined) => {
+        const searchInput = term || '';
         const source = items.map(item => ({
           name: `${item.displayName}  ${colorize(item.timeLabel, 'dim')}`,
           value: item,
@@ -47,8 +43,7 @@ async function main() {
           value: result.original,
         }));
       },
-      pageSize: 15,
-    } as any]);
+    });
 
     const item = selected as { session: WorkspaceSession };
     const session = item.session;

package/src/commands/dashboard/workspace-picker.ts

@@ -8,12 +8,9 @@
 import { listWorkspaces } from '../../utils/workspace-meta';
 import { launchAgentPane } from './launcher';
 import { getPrimaryAgent } from '../../utils/agent-config';
-import inquirer from 'inquirer';
-import autocompletePrompt from 'inquirer-autocomplete-prompt';
+import { search } from '../../utils/prompt';
 import * as fuzzy from 'fuzzy';
 
-inquirer.registerPrompt('autocomplete', autocompletePrompt);
-
 async function main() {
   try {
     const workspaces = await listWorkspaces();
@@ -29,12 +26,11 @@ async function main() {
       repoCount: ws.metadata?.repositories?.length ?? 0,
     }));
 
-    const { selected } = await inquirer.prompt([{
-      type: 'autocomplete',
-      name: 'selected',
+    const selected = await search<typeof items[number]>({
       message: 'Select workspace to launch agent in:',
-      source: async (_answersSoFar: any, input: string | undefined) => {
-        const searchInput = input || '';
+      pageSize: 15,
+      source: async (term: string | undefined) => {
+        const searchInput = term || '';
         const source = items.map(item => ({
           name: `${item.name}  (${item.repoCount} repos)`,
           value: item,
@@ -46,8 +42,7 @@ async function main() {
           value: result.original,
         }));
       },
-      pageSize: 15,
-    } as any]);
+    });
 
     const workspace = selected as { name: string; path: string };
     const agent = getPrimaryAgent();