@agentworkforce/cli 0.19.0 → 2.1.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.0] - 2026-05-11
+
+### Changed
+
+- Persona-tui: address review feedback
+- Cli: open interactive persona picker on bare invocation
+
+## [2.0.1] - 2026-05-11
+
+### Changed
+
+- Migrate workforce CLI to consume persona-kit directly (#67)
+- Move persona-shape code from harness-kit + workload-router into persona-kit (#65)
+- Delete @agentworkforce/harness-kit from the monorepo (#65)
+- Shrink workload-router: drop persona-domain re-exports (1.0.0) (#68)
+- RunPersonaImprover: restore config files in try/finally
+- RunPersonaImprover: escalate to SIGKILL after SIGTERM grace
+
 ## [0.19.0] - 2026-05-08
 
 ### Changed

package/dist/cli.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { type Harness, type PersonaMount, type PersonaSelection, type SidecarMdMode } from '@agentworkforce/workload-router';
+import { type Harness, type PersonaMount, type PersonaSelection, type SidecarMdMode } from '@agentworkforce/persona-kit';
 import { type PickCandidate } from './persona-picker.js';
+import { type TuiCandidate } from './persona-tui.js';
 export declare const CLI_VERSION: string;
 export declare const CREATE_SELECTOR = "persona-maker@best";
 /**
@@ -22,11 +23,11 @@ export declare function resolveSystemPromptPlaceholders(prompt: string, harness:
  * launching opencode without a persona-specific agent selection.
  *
  * Strips all occurrences rather than just the first — the current producer
- * (harness-kit's opencode branch) emits exactly one pair, so both behaviors
- * are equivalent today, but "remove all" is idempotent and safer if a future
- * caller ever appends a second `--agent` for any reason. A trailing `--agent`
- * with no following value is preserved so the malformed argv surfaces at the
- * harness rather than getting silently swallowed here.
+ * (the opencode branch in persona-kit) emits exactly one pair, so both
+ * behaviors are equivalent today, but "remove all" is idempotent and safer if
+ * a future caller ever appends a second `--agent` for any reason. A trailing
+ * `--agent` with no following value is preserved so the malformed argv
+ * surfaces at the harness rather than getting silently swallowed here.
  */
 export declare function stripAgentFlag(args: readonly string[]): string[];
 /**
@@ -180,6 +181,13 @@ export declare function readSingleCharChoice(prompt: string, valid: readonly str
  * unsupported patch op/path resolution.
  */
 export declare function applyAcceptedPatches(personaFilePath: string, accepted: readonly ImproverProposal[]): void;
+/**
+ * Enumerate personas for the interactive TUI. Source label mirrors the cascade
+ * shown by `agentworkforce list` so the picker tells the user *where* a
+ * persona is coming from (cwd, user, dir:n, library) without a separate
+ * lookup.
+ */
+export declare function buildTuiCandidates(): TuiCandidate[];
 /**
  * Enumerate persona candidates for the picker. Local overrides win over the
  * built-in catalog when ids collide; the picker only needs the projection

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAsBA,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAIrB,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAkCzC,OAAO,EAAe,KAAK,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AA8JvF,eAAO,MAAM,WAAW,QAAuB,CAAC;AAChD,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAiHpD;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAExF;AAkND;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAUhE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAe5D;AAED;;;kDAGkD;AAClD,eAAO,MAAM,sBAAsB,gFAUzB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,2JAiBjC,CAAC;AAEX,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GAAG,sBAAsB,CAqBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAU7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAuCxF;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,SAAS,EAAE,WAAW,GAAG,WAAW,CAAC;IACrC,uFAAuF;IACvF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,gBAAgB,GAC1B;IAAE,OAAO,CAAC,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAyDjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,MAAM,CAkBR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,aAAa,UAAQ,GACpB;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAKvB;AAs5BD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CA+B5E;AAkvBD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,GAAG,QAAQ,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAsFD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AA+bD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA6DjE;AA4ED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,GAAE;IACJ,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC5B,GACL,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,IAAI,CASN;AAyCD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,EAAE,CAmBrD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IACJ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC5B,GACL,OAAO,CAWT;AAiGD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiE1C;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IACvD,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAoCA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IACxD,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CA6EA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -5,16 +5,21 @@ import { appendFileSync, closeSync, existsSync, mkdirSync, mkdtempSync, openSync
 import { constants, homedir, tmpdir } from 'node:os';
 import { dirname, isAbsolute, join, resolve as resolvePath } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { HARNESS_VALUES, materializeSkills, PERSONA_TAGS, PERSONA_TIERS, listBuiltInPersonas, personaCatalog, resolveSidecar, routingProfiles, useSelection } from '@agentworkforce/workload-router';
-import { buildInteractiveSpec, detectHarnesses, formatDropWarnings, MissingPersonaInputError, renderPersonaInputs, resolvePersonaInputs, resolveMcpServersLenient, resolveStringMapLenient, useRunnableSelection } from '@agentworkforce/harness-kit';
+import { buildCleanupArtifacts, buildInstallArtifacts, buildInteractiveSpec, buildNonInteractiveSpec, detectHarnesses, formatDropWarnings, HARNESS_VALUES, materializeSkills, MissingPersonaInputError, PERSONA_TAGS, PERSONA_TIERS, renderPersonaInputs, resolveMcpServersLenient, resolvePersonaInputs, resolveSidecar, resolveStringMapLenient } from '@agentworkforce/persona-kit';
+import { listBuiltInPersonas, personaCatalog, routingProfiles } from '@agentworkforce/workload-router';
 import { createMount, readAgentDotfiles } from '@relayfile/local-mount';
 import ora from 'ora';
 import { startLaunchMetadataRecording } from './launch-metadata.js';
 import { buildPersonaSourceDirectories, defaultCwdPersonaDir, loadLocalPersonas, loadPersonaSourceConfig, normalizePersonaDir, savePersonaSourceConfig } from './local-personas.js';
 import { installPersonas } from './persona-install.js';
 import { pickPersona } from './persona-picker.js';
+import { recordRecent, loadRecents, runPersonaPickerTui } from './persona-tui.js';
 const USAGE = `Usage: agentworkforce <command> [args...]
 
+Run with no arguments inside a TTY to open an interactive persona picker —
+the top 3 most recently used personas are shown first, and typing fuzzy-
+searches across persona names and descriptions.
+
 Commands:
   create [flags]     Opens persona-maker@best for creating a new
                       persona, with target path passed as persona inputs.
@@ -418,6 +423,18 @@ async function runInstallOrThrow(command, label, cwd) {
         throw new InstallCommandError(label, code);
     }
 }
+function buildInstallContext(selection, options = {}) {
+    const plan = materializeSkills(selection.skills, selection.runtime.harness, options.installRoot !== undefined ? { installRoot: options.installRoot } : {});
+    const { installCommand, installCommandString } = buildInstallArtifacts(plan);
+    const { cleanupCommand, cleanupCommandString } = buildCleanupArtifacts(plan);
+    return {
+        plan,
+        command: installCommand,
+        commandString: installCommandString,
+        cleanupCommand,
+        cleanupCommandString
+    };
+}
 function runCleanup(command, commandString) {
     if (commandString === ':')
         return;
@@ -475,11 +492,11 @@ function sessionMountDir(sessionRoot) {
  * launching opencode without a persona-specific agent selection.
  *
  * Strips all occurrences rather than just the first — the current producer
- * (harness-kit's opencode branch) emits exactly one pair, so both behaviors
- * are equivalent today, but "remove all" is idempotent and safer if a future
- * caller ever appends a second `--agent` for any reason. A trailing `--agent`
- * with no following value is preserved so the malformed argv surfaces at the
- * harness rather than getting silently swallowed here.
+ * (the opencode branch in persona-kit) emits exactly one pair, so both
+ * behaviors are equivalent today, but "remove all" is idempotent and safer if
+ * a future caller ever appends a second `--agent` for any reason. A trailing
+ * `--agent` with no following value is preserved so the malformed argv
+ * surfaces at the harness rather than getting silently swallowed here.
  */
 export function stripAgentFlag(args) {
     const out = [];
@@ -806,7 +823,7 @@ function runDryRun(selection) {
         return 1;
     }
     process.stderr.write(`✓ sidecar: ${sidecarLookup.sidecar ? sidecarLookup.sidecar.mountFile : '(none)'}\n`);
-    // Check 2: harness-kit translation. buildInteractiveSpec validates
+    // Check 2: persona-kit translation. buildInteractiveSpec validates
     // permissions shape, mcpServers shape, and required runtime fields.
     // We resolve env + mcp leniently (same as the live launch path) so
     // the spec call sees the same inputs it would at runtime.
@@ -932,8 +949,7 @@ async function runInteractive(selection, options) {
     const installRoot = sessionRoot && runtime.harness === 'claude'
         ? sessionInstallRoot(sessionRoot)
         : undefined;
-    const ctx = useSelection(effectiveSelection, installRoot !== undefined ? { installRoot } : {});
-    const { install } = ctx;
+    const install = buildInstallContext(effectiveSelection, installRoot !== undefined ? { installRoot } : {});
     process.stderr.write(`→ ${personaId} [${tier}] via ${runtime.harness} (${runtime.model})\n`);
     const startLaunchMetadataForLaunch = (cwd = process.cwd()) => startLaunchMetadataRecording({
         selection: effectiveSelection,
@@ -2130,6 +2146,9 @@ async function runAgentSelector(selector, flags, inputValues) {
         const code = runDryRun(selection);
         process.exit(code);
     }
+    // Record only on real launches so `--dry-run` validations don't pollute the
+    // MRU list used by the bare-invocation picker.
+    recordRecent(target.spec.id);
     const capture = {};
     const code = await runInteractive(selection, {
         installInRepo: flags.installInRepo,
@@ -2707,23 +2726,110 @@ async function runPersonaImprover(args) {
     }
     const tier = 'best-value';
     const selection = buildSelection(improverSpec, tier, 'repo');
-    const ctx = useRunnableSelection(selection);
-    const taskLines = [
+    const inputValues = {
+        PERSONA_FILE_PATH: args.personaFilePath,
+        SESSION_TRANSCRIPT_PATH: args.transcriptPath,
+        PROPOSALS_OUTPUT_PATH: args.proposalsOutputPath
+    };
+    const inputResolution = resolvePersonaInputs(selection.inputs, inputValues, process.env);
+    const renderedSystemPrompt = renderPersonaInputs(selection.runtime.systemPrompt, inputResolution.values);
+    const callerEnv = { ...process.env, ...inputResolution.values };
+    const envResolution = resolveStringMapLenient(selection.env, callerEnv, 'env');
+    const mcpResolution = resolveMcpServersLenient(selection.mcpServers, callerEnv);
+    const taskBody = [
         'Improve this local persona from one finished session. The CLI will read your proposals JSON and walk the user through accept/deny.',
         `PERSONA_FILE_PATH=${args.personaFilePath}`,
         `SESSION_TRANSCRIPT_PATH=${args.transcriptPath}`,
         `PROPOSALS_OUTPUT_PATH=${args.proposalsOutputPath}`
-    ];
-    const result = await ctx.sendMessage(taskLines.join('\n'), {
-        inputs: {
-            PERSONA_FILE_PATH: args.personaFilePath,
-            SESSION_TRANSCRIPT_PATH: args.transcriptPath,
-            PROPOSALS_OUTPUT_PATH: args.proposalsOutputPath
-        },
-        timeoutSeconds: selection.runtime.harnessSettings.timeoutSeconds
+    ].join('\n');
+    const task = `${taskBody}\n\nRun inputs:\n${JSON.stringify(inputValues, null, 2)}`;
+    const spec = buildNonInteractiveSpec({
+        harness: selection.runtime.harness,
+        personaId: selection.personaId,
+        model: selection.runtime.model,
+        systemPrompt: renderedSystemPrompt,
+        harnessSettings: selection.runtime.harnessSettings,
+        mcpServers: mcpResolution.servers,
+        permissions: selection.permissions,
+        task
     });
-    if (result.status !== 'completed' || (result.exitCode !== null && result.exitCode !== 0)) {
-        throw new Error(`improver exited with status=${result.status}, code=${result.exitCode ?? 'null'}.${result.stderr ? ` stderr: ${result.stderr.slice(0, 400)}` : ''}`);
+    const childEnv = { ...callerEnv, ...(envResolution.value ?? {}), ...inputResolution.values };
+    const cwd = process.cwd();
+    const configWrites = [];
+    for (const file of spec.configFiles) {
+        assertSafeRelativePath(file.path);
+        const target = join(cwd, file.path);
+        const existed = existsSync(target);
+        const previous = existed ? readFileSync(target, 'utf8') : undefined;
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, file.contents, 'utf8');
+        configWrites.push({ path: target, existed, ...(previous !== undefined ? { previous } : {}) });
+    }
+    const restoreConfigWrites = () => {
+        for (const write of [...configWrites].reverse()) {
+            if (write.existed) {
+                writeFileSync(write.path, write.previous ?? '', 'utf8');
+            }
+            else {
+                rmSync(write.path, { force: true });
+            }
+        }
+    };
+    const timeoutMs = selection.runtime.harnessSettings.timeoutSeconds
+        ? selection.runtime.harnessSettings.timeoutSeconds * 1000
+        : undefined;
+    let captureResult;
+    try {
+        captureResult = await new Promise((resolveResult) => {
+            const child = spawn(spec.bin, [...spec.args], {
+                cwd,
+                env: childEnv,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                shell: false
+            });
+            let stderrBuf = '';
+            let forceKillTimeout;
+            child.stdout?.setEncoding('utf8');
+            child.stderr?.setEncoding('utf8');
+            child.stderr?.on('data', (chunk) => {
+                stderrBuf += chunk;
+            });
+            // SIGTERM first; if the harness traps or ignores it, escalate to
+            // SIGKILL after a 1s grace so the timeout is actually enforced.
+            const timeout = timeoutMs !== undefined
+                ? setTimeout(() => {
+                    child.kill('SIGTERM');
+                    forceKillTimeout = setTimeout(() => {
+                        if (!child.killed)
+                            child.kill('SIGKILL');
+                    }, 1000);
+                }, timeoutMs)
+                : undefined;
+            const clearTimers = () => {
+                if (timeout)
+                    clearTimeout(timeout);
+                if (forceKillTimeout)
+                    clearTimeout(forceKillTimeout);
+            };
+            child.on('error', (err) => {
+                clearTimers();
+                resolveResult({ exitCode: 1, stderr: `${stderrBuf}${err.message}\n` });
+            });
+            child.on('close', (code, signal) => {
+                clearTimers();
+                const exitCode = typeof code === 'number' ? code : signal ? signalExitCode(signal) : null;
+                resolveResult({ exitCode, stderr: stderrBuf });
+            });
+        });
+    }
+    finally {
+        // Always restore — a synchronous spawn() throw or unexpected promise
+        // rejection must not leave orphaned `opencode.json` (or any other
+        // configFile) sitting in the user's working directory.
+        restoreConfigWrites();
+    }
+    if (captureResult.exitCode !== 0) {
+        throw new Error(`improver exited with code=${captureResult.exitCode ?? 'null'}.${captureResult.stderr ? ` stderr: ${captureResult.stderr.slice(0, 400)}` : ''}`);
     }
     let raw;
     try {
@@ -2949,6 +3055,55 @@ function applyPatchInPlace(root, patch) {
     // op === 'set'
     cursor[finalSeg] = patch.value;
 }
+/**
+ * Enumerate personas for the interactive TUI. Source label mirrors the cascade
+ * shown by `agentworkforce list` so the picker tells the user *where* a
+ * persona is coming from (cwd, user, dir:n, library) without a separate
+ * lookup.
+ */
+export function buildTuiCandidates() {
+    const byId = new Map();
+    for (const spec of listBuiltInPersonas()) {
+        byId.set(spec.id, { id: spec.id, description: spec.description, source: 'library' });
+    }
+    for (const [id, spec] of local.byId.entries()) {
+        byId.set(id, {
+            id,
+            description: spec.description,
+            source: local.sources.get(id) ?? 'library'
+        });
+    }
+    return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+/**
+ * Bare-invocation flow: open the interactive TUI, then hand the chosen
+ * persona to {@link runAgentSelector}. Quitting the picker (Esc / Ctrl-C)
+ * exits with conventional 130 so shell pipelines see SIGINT-style failure.
+ *
+ * runAgentSelector terminates the process via process.exit; this function
+ * only returns when the picker is dismissed without a selection.
+ */
+async function runInteractivePicker() {
+    const candidates = buildTuiCandidates();
+    if (candidates.length === 0) {
+        process.stderr.write('No personas available. Try `agentworkforce install <pack>` or run with --help.\n');
+        process.exit(1);
+    }
+    const selected = await runPersonaPickerTui({
+        candidates,
+        recentIds: loadRecents()
+    });
+    if (!selected) {
+        process.exit(130);
+    }
+    await runAgentSelector(selected, {
+        installInRepo: false,
+        noLaunchMetadata: false,
+        dryRun: false
+    });
+    // runAgentSelector has Promise<never> return type; this is unreachable.
+    process.exit(0);
+}
 /**
  * Enumerate persona candidates for the picker. Local overrides win over the
  * built-in catalog when ids collide; the picker only needs the projection
@@ -3075,9 +3230,19 @@ async function runPick(args) {
 export async function main() {
     const argv = process.argv.slice(2);
     const [subcommand, ...rest] = argv;
-    if (!subcommand || subcommand === '-h' || subcommand === '--help') {
+    if (subcommand === '-h' || subcommand === '--help') {
         process.stdout.write(USAGE);
-        process.exit(subcommand ? 0 : 1);
+        process.exit(0);
+    }
+    if (!subcommand) {
+        if (process.stdin.isTTY && process.stderr.isTTY) {
+            await runInteractivePicker();
+            // runInteractivePicker either runAgentSelector → process.exit, or
+            // exits itself on quit / no-match. Satisfy TS's unreachable check.
+            process.exit(0);
+        }
+        process.stdout.write(USAGE);
+        process.exit(1);
     }
     if (subcommand === '-v' || subcommand === '--version') {
         process.stdout.write(`${CLI_VERSION}\n`);