@fnclaude/cli 1.1.0 → 2.0.0

package/src/config.ts

@@ -1,369 +0,0 @@
-// Port of src/config.go (fnclaude/fnclaude Go reference).
-//
-// Holds all fnclaude configuration, merged from defaults, the config file,
-// and environment variables (env overrides config, config overrides built-in
-// defaults).
-//
-// TOML parsing uses Bun's built-in `Bun.TOML.parse` — no external dependency.
-
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { errorMessage } from './errors.js';
-
-/**
- * Resolve the user's home directory. Honors `$HOME` first (matches Go's
- * `os.UserHomeDir()` precedence on Unix), then falls back to `os.homedir()`.
- * Tests rely on being able to override HOME at runtime.
- */
-function home(): string {
-  return process.env.HOME ?? homedir();
-}
-
-// ── public types ───────────────────────────────────────────────────────────
-
-export type TmuxMode = 'never' | 'worktree';
-/**
- * `'never'`, `'ask'`, or a non-negative integer-as-string (e.g. `'5'`).
- *
- * The template-literal `${number}` variant narrows correctly: a bare
- * `string` would collapse the union, so runtime validation gates env-var
- * and config-file inputs into this type via `normalizeHandoffMode`.
- */
-export type HandoffMode = 'never' | 'ask' | `${number}`;
-
-export interface NameConfig {
-  /** Model used for the noop name session. */
-  model: string;
-  /** Timeout for the noop name session, expressed in milliseconds. */
-  timeout: number;
-  /** When true, suppresses the missing-API-key startup warning. */
-  quietMissingAPIKey: boolean;
-}
-
-export interface AutoConfig {
-  /**
-   * Auto-injection of --tmux. "never" or "worktree".
-   * Anything else (including the deprecated "always") is normalized to
-   * "never" with a stderr warning during config load.
-   */
-  tmux: TmuxMode;
-
-  /**
-   * Auto-handoff prompt mode. One of:
-   *   "never" — never auto-switch; user pastes the rendered command.
-   *   "ask"   — noop session asks; on yes, fnclaude relaunches.
-   *   "<N>"   — non-negative integer; auto-switch after N seconds.
-   * Invalid values normalize to "ask" with a stderr warning during load.
-   */
-  handoff: HandoffMode;
-
-  /**
-   * Launcher template used by fnc_spawn_session to open a sibling
-   * fnclaude in a new window. Whitespace-tokenized into argv; tokens
-   * are then placeholder-substituted before exec. Supported
-   * placeholders: {bin}, {dest}, {name}, {summary}. Empty means
-   * "auto-detect from environment, fall back to paste-flow".
-   */
-  spawnCommand: string;
-}
-
-export interface ExecConfig {
-  /**
-   * Additional environment variables to inject into the claude child's
-   * environment, sourced from [exec.env] in the config file. Appended
-   * AFTER os env when spawning claude — by exec last-wins semantics a
-   * configured key beats any inherited value with the same name.
-   */
-  env: Record<string, string>;
-}
-
-export interface Config {
-  name: NameConfig;
-  auto: AutoConfig;
-  exec: ExecConfig;
-}
-
-// ── defaults ───────────────────────────────────────────────────────────────
-
-export function defaultConfig(): Config {
-  return {
-    name: {
-      model: 'claude-haiku-4-5',
-      timeout: 3_000, // 3s
-      quietMissingAPIKey: false,
-    },
-    auto: {
-      tmux: 'never',
-      handoff: 'ask',
-      spawnCommand: '',
-    },
-    exec: {
-      env: {},
-    },
-  };
-}
-
-// ── config file path ───────────────────────────────────────────────────────
-
-export function configFilePath(): string {
-  const xdg = process.env.XDG_CONFIG_HOME;
-  const base = xdg && xdg.length > 0 ? xdg : join(home(), '.config');
-  return join(base, 'fnclaude', 'config.toml');
-}
-
-// ── helpers ────────────────────────────────────────────────────────────────
-
-/**
- * parseBoolEnv returns true for "1", "true", "yes" (case-insensitive),
- * false for anything else.
- */
-export function parseBoolEnv(v: string): boolean {
-  switch (v.trim().toLowerCase()) {
-    case '1':
-    case 'true':
-    case 'yes':
-      return true;
-    default:
-      return false;
-  }
-}
-
-/**
- * Result of a normalize-mode call: the validated value plus an optional
- * warning describing any fallback that was applied. Callers thread the
- * warning into their own returned warnings list rather than mutating a
- * module-global sink.
- */
-export interface NormalizeResult<T> {
-  value: T;
-  warning: string | undefined;
-}
-
-/**
- * normalizeTmuxMode validates against the supported set and falls back to
- * "never" for anything else, returning the fallback value and an optional
- * warning describing what was rejected (the empty-string case is the
- * absent-value default path and produces no warning).
- */
-export function normalizeTmuxMode(v: string): NormalizeResult<TmuxMode> {
-  if (v === 'never' || v === 'worktree') return { value: v, warning: undefined };
-  if (v === '') return { value: 'never', warning: undefined };
-  return {
-    value: 'never',
-    warning: `fnclaude: auto.tmux=${JSON.stringify(v)} is not a valid mode (use "never" or "worktree"), falling back to "never"`,
-  };
-}
-
-/**
- * normalizeHandoffMode validates against the supported set and falls back
- * to "ask" for anything else (with an optional warning, except empty
- * string). Valid: "never", "ask", or a non-negative integer (as a string).
- */
-export function normalizeHandoffMode(v: string): NormalizeResult<HandoffMode> {
-  if (v === 'never' || v === 'ask') return { value: v, warning: undefined };
-  if (v === '') return { value: 'ask', warning: undefined };
-  // Non-negative integer (no decimal, no unit). The regex guarantees the
-  // template-literal shape, which TS's type narrowing can't infer from a
-  // .test() call alone — so assert it explicitly once.
-  if (/^\d+$/.test(v)) return { value: v as `${number}`, warning: undefined };
-  return {
-    value: 'ask',
-    warning: `fnclaude: auto.handoff=${JSON.stringify(v)} is not a valid mode (use "never", "ask", or a non-negative integer), falling back to "ask"`,
-  };
-}
-
-/**
- * parseDuration accepts a Go-style duration string (e.g., "3s", "150ms",
- * "1m30s") and returns the equivalent in milliseconds. Returns undefined
- * on parse failure. This is the same surface as Go's time.ParseDuration
- * for the config use-case (we don't need ns/us precision).
- */
-export function parseDuration(s: string): number | undefined {
-  if (!s) return undefined;
-  // Whole number with unit suffix(es).
-  // Units: ns, us, µs, ms, s, m, h. (We support all common units.)
-  const unitToMs: Record<string, number> = {
-    ns: 1e-6,
-    us: 1e-3,
-    'µs': 1e-3,
-    ms: 1,
-    s: 1_000,
-    m: 60_000,
-    h: 3_600_000,
-  };
-  const re = /([0-9]*\.?[0-9]+)(ns|us|µs|ms|s|m|h)/g;
-  let total = 0;
-  let matched = 0;
-  let consumed = 0;
-  // RegExp.exec returns null for "no match" — third-party API shape, kept
-  // as null rather than coerced.
-  let m: RegExpExecArray | null;
-  while ((m = re.exec(s)) !== null) {
-    if (m.index !== consumed) return undefined; // gap between matches
-    const num = parseFloat(m[1] as string);
-    const unit = m[2] as string;
-    if (!Number.isFinite(num) || num < 0) return undefined;
-    total += num * (unitToMs[unit] as number);
-    consumed = m.index + m[0].length;
-    matched++;
-  }
-  if (matched === 0 || consumed !== s.length) return undefined;
-  return total;
-}
-
-// ── raw TOML shape (mirrors the Go rawConfig) ──────────────────────────────
-
-interface RawConfig {
-  name?: {
-    model?: string;
-    timeout?: string;
-    quiet_missing_api_key?: boolean;
-  };
-  auto?: {
-    tmux?: string;
-    handoff?: string;
-    spawn_command?: string;
-    // legacy keys (silently ignored): dangerously_skip_permissions, ide
-    [k: string]: unknown;
-  };
-  exec?: {
-    env?: Record<string, string>;
-  };
-  [k: string]: unknown;
-}
-
-// ── loadConfig ─────────────────────────────────────────────────────────────
-
-/**
- * Result of `loadConfig` — the merged Config plus any non-fatal warnings
- * raised during the load (malformed file, invalid mode value, bogus
- * duration, etc.). The caller threads warnings into the deferred-flush
- * mechanism in `main.ts`; this module owns no global mutable state.
- */
-export interface LoadConfigResult {
-  config: Config;
-  warnings: readonly string[];
-}
-
-/**
- * loadConfig loads the configuration from the config file and environment
- * variables, merging over built-in defaults. Order of precedence:
- *
- *   env var > config file > built-in default
- *
- * A missing config file is not an error. A malformed config file produces
- * a warning and falls back to defaults.
- */
-export function loadConfig(): LoadConfigResult {
-  const cfg = defaultConfig();
-  const warnings: string[] = [];
-  const path = configFilePath();
-
-  const recordNormalize = <T>(
-    r: NormalizeResult<T>,
-    set: (v: T) => void,
-  ): void => {
-    set(r.value);
-    if (r.warning !== undefined) warnings.push(r.warning);
-  };
-
-  if (existsSync(path)) {
-    let raw: RawConfig | undefined;
-    try {
-      const body = readFileSync(path, 'utf8');
-      raw = Bun.TOML.parse(body) as RawConfig;
-    } catch (err) {
-      warnings.push(
-        `fnclaude: config file ${path} is malformed, using defaults: ${errorMessage(err)}`,
-      );
-      raw = undefined;
-    }
-    if (raw) {
-      if (raw.name?.model) cfg.name.model = raw.name.model;
-      if (raw.name?.timeout) {
-        const d = parseDuration(raw.name.timeout);
-        if (d !== undefined) {
-          cfg.name.timeout = d;
-        } else {
-          warnings.push(
-            `fnclaude: invalid timeout ${JSON.stringify(raw.name.timeout)} in config, using default`,
-          );
-        }
-      }
-      if (typeof raw.name?.quiet_missing_api_key === 'boolean') {
-        cfg.name.quietMissingAPIKey = raw.name.quiet_missing_api_key;
-      }
-      if (typeof raw.auto?.tmux === 'string' && raw.auto.tmux !== '') {
-        recordNormalize(normalizeTmuxMode(raw.auto.tmux), (v) => {
-          cfg.auto.tmux = v;
-        });
-      }
-      if (typeof raw.auto?.handoff === 'string' && raw.auto.handoff !== '') {
-        recordNormalize(normalizeHandoffMode(raw.auto.handoff), (v) => {
-          cfg.auto.handoff = v;
-        });
-      }
-      if (
-        typeof raw.auto?.spawn_command === 'string' &&
-        raw.auto.spawn_command !== ''
-      ) {
-        cfg.auto.spawnCommand = raw.auto.spawn_command;
-      }
-      if (raw.exec?.env && Object.keys(raw.exec.env).length > 0) {
-        cfg.exec.env = { ...raw.exec.env };
-      }
-    }
-  }
-
-  // Env-var overrides.
-  const e = process.env;
-  if (e.FNCLAUDE_NAME_MODEL) cfg.name.model = e.FNCLAUDE_NAME_MODEL;
-  if (e.FNCLAUDE_NAME_TIMEOUT) {
-    const d = parseDuration(e.FNCLAUDE_NAME_TIMEOUT);
-    if (d !== undefined) {
-      cfg.name.timeout = d;
-    } else {
-      warnings.push(
-        `fnclaude: invalid FNCLAUDE_NAME_TIMEOUT ${JSON.stringify(e.FNCLAUDE_NAME_TIMEOUT)}, using current value`,
-      );
-    }
-  }
-  if (e.FNCLAUDE_QUIET_MISSING_API_KEY) {
-    cfg.name.quietMissingAPIKey = parseBoolEnv(e.FNCLAUDE_QUIET_MISSING_API_KEY);
-  }
-  if (e.FNCLAUDE_TMUX) {
-    recordNormalize(normalizeTmuxMode(e.FNCLAUDE_TMUX), (v) => {
-      cfg.auto.tmux = v;
-    });
-  }
-  if (e.FNCLAUDE_HANDOFF) {
-    recordNormalize(normalizeHandoffMode(e.FNCLAUDE_HANDOFF), (v) => {
-      cfg.auto.handoff = v;
-    });
-  }
-  if (e.FNCLAUDE_SPAWN_COMMAND) cfg.auto.spawnCommand = e.FNCLAUDE_SPAWN_COMMAND;
-
-  return { config: cfg, warnings };
-}
-
-// ── envFromConfig ─────────────────────────────────────────────────────────
-
-/**
- * envFromConfig returns cfg.exec.env rendered as a sorted array of
- * "KEY=VALUE" strings, ready to append to the parent's env before
- * spawning claude. Sort order is deterministic so debug output is stable.
- *
- * Precedence rule: callers append this AFTER the inherited env; if the
- * spawning API resolves duplicate keys by last-wins (Node's
- * child_process.spawn does, since it accepts an object), a configured key
- * here overrides the inherited value of the same name when callers merge
- * appropriately.
- */
-export function envFromConfig(cfg: Config): string[] {
-  const env = cfg.exec?.env;
-  if (!env) return [];
-  const keys = Object.keys(env).sort();
-  if (keys.length === 0) return [];
-  return keys.map((k) => `${k}=${env[k]}`);
-}

package/src/errors.ts

@@ -1,13 +0,0 @@
-// Error-handling helpers shared across the CLI.
-//
-// `errorMessage` collapses the "throw value can be anything" branch into a
-// single safe path: real Errors yield their `.message`, anything else gets
-// stringified. Used at every catch-and-format site that previously did
-// `(err as Error).message` — a cast that silently produces `undefined` (and
-// then crashes the error-handling path itself) whenever the thrown value
-// isn't actually an Error instance.
-
-export function errorMessage(err: unknown): string {
-  if (err instanceof Error) return err.message;
-  return String(err);
-}

package/src/handoff.ts

@@ -1,108 +0,0 @@
-// Port of src/handoff.go (fnclaude/fnclaude Go reference).
-//
-// Resolves the directory and per-session filenames that fnc uses for its
-// AF_UNIX socket (parent listener) and handoff-summary scratch files, and
-// renders the FNCLAUDE_HANDOFF + FNC_SOCKET pair to inject into the claude
-// child's environment.
-
-import { randomBytes } from 'node:crypto';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-/**
- * Resolve the directory where handoff files (socket and summary content)
- * should live. Single point of truth, used by both handoffSocketPath and
- * handoffContentPath.
- *
- * Preference order:
- *
- *  1. $XDG_RUNTIME_DIR — the Linux/systemd ideal: tmpfs, mode 700, auto-
- *     cleared on user logout. Permissions are restrictive by default so
- *     other users on the box can't read handoff content (often includes
- *     conversation context, tool-call results, or other session-private
- *     data).
- *  2. os.tmpdir() — the OS-native fallback. On Unix this honors $TMPDIR
- *     then falls back to /tmp; on macOS launchd sets $TMPDIR to a per-user
- *     mode-700 dir under /var/folders/; on Windows it returns %TMP% /
- *     %TEMP% / %USERPROFILE%. Using tmpdir() (vs a hardcoded "/tmp"
- *     literal) is what makes this code portable.
- */
-export function handoffBaseDir(): string {
-  const xdg = process.env.XDG_RUNTIME_DIR;
-  if (xdg && xdg.length > 0) return xdg;
-  return tmpdir();
-}
-
-/**
- * Return the AF_UNIX socket path the parent listens on for MCP-side
- * Requests. PID is included so concurrent fnclaude sessions don't collide.
- *
- * AF_UNIX paths on Linux/Darwin are limited to ~108 bytes (sun_path
- * length); handoffBaseDir + "fnclaude-mcp-<pid>.sock" stays well under
- * that cap for every realistic PID.
- */
-export function handoffSocketPath(pid: number): string {
-  return join(handoffBaseDir(), `fnclaude-mcp-${pid}.sock`);
-}
-
-/**
- * Return the env-var entries (KEY=VALUE strings) that fnc injects into
- * the claude child's environment when auto-handoff is active.
- *
- *  - FNCLAUDE_HANDOFF=<mode> tells the noop session which UX to use when
- *    proposing a project transfer.
- *  - FNC_SOCKET=<path> tells the `fnclaude mcp` subprocess (spawned by
- *    claude) where to dial the parent's AF_UNIX listener.
- *
- * `mode` is the resolved Auto.Handoff value ("never", "ask", or a
- * non-negative integer); all three are valid here because the listener
- * still needs to answer OpRestart and OpCopy regardless of the noop
- * proposal mode.
- */
-export function handoffEnv(mode: string, socketPath: string): string[] {
-  return [`FNCLAUDE_HANDOFF=${mode}`, `FNC_SOCKET=${socketPath}`];
-}
-
-/**
- * Return a unique path where the listener can write the handoff summary
- * content for an OpSwitch Request. Uses a random hex token to guarantee
- * uniqueness — no risk of collision via PID recycling even if the user
- * delays pasting a rendered relaunch command for hours.
- */
-export function handoffContentPath(): string {
-  const base = handoffBaseDir();
-  // 8 bytes → 16 hex chars, 64 bits of entropy.
-  const token = randomBytes(8).toString('hex');
-  return join(base, `fnclaude-handoff-content-${token}.md`);
-}
-
-/**
- * Configures fnc's auto-handoff machinery for a single PTY run. Passed as
- * a parameter to the spawn entry point; `null` means handoff disabled,
- * no env injection, no socket listener (the legacy code path).
- */
-export interface HandoffSpec {
-  /**
-   * Resolved Auto.Handoff value ("never", "ask", or a non-negative
-   * integer-as-string). The parent's socket-listener dispatcher consults
-   * Mode when answering OpSwitch (initial, non-Confirmed) requests.
-   */
-  mode: string;
-
-  /**
-   * Filesystem path of the AF_UNIX socket the parent listens on for
-   * MCP-side Requests. fnc generates this per-session from its PID so
-   * concurrent sessions don't collide. The MCP subprocess receives it
-   * via $FNC_SOCKET and dials it for every tool invocation.
-   */
-  socketPath: string;
-
-  /**
-   * Snapshot of process.argv from the fnclaude invocation (typically
-   * `process.argv.slice(2)`), threaded through to the socket listener so
-   * handleRestart and handleSwitch can preserve user-supplied flags across
-   * the relaunch. Empty array is allowed — handlers fall back to the
-   * flag-less relaunch shape.
-   */
-  originalArgs: string[];
-}

package/src/help.ts

@@ -1,139 +0,0 @@
-// Help text + flag scanners for fnclaude's own --help / --version.
-// Ported from src/main.go (helpText, wantsHelp, wantsVersion) in the Go
-// reference.
-
-import pkg from '../package.json' with { type: 'json' };
-
-/**
- * Binary version. Read from package.json at build time, inlined by the
- * TypeScript compiler and bundler.
- */
-export let version = pkg.version;
-
-/**
- * Test helper: override the reported version. Kept narrow on purpose —
- * production callers should not mutate this at runtime.
- */
-export function setVersion(v: string): void {
-  version = v;
-}
-
-/**
- * True when the user passed -v or --version anywhere in argv BEFORE a
- * literal "--" terminator. fnclaude shadows claude's -v short flag (the
- * only lowercase short fnclaude claims); to reach claude's own --version,
- * the user runs `claude --version` directly.
- */
-export function wantsVersion(argv: readonly string[]): boolean {
-  for (const t of argv) {
-    if (t === '--') return false;
-    if (t === '-v' || t === '--version') return true;
-  }
-  return false;
-}
-
-/**
- * True when the user passed -h or --help anywhere in argv BEFORE a literal
- * "--" terminator. Tokens after "--" are part of the prompt to claude and
- * aren't fnclaude flags.
- */
-export function wantsHelp(argv: readonly string[]): boolean {
-  for (const t of argv) {
-    if (t === '--') return false;
-    if (t === '-h' || t === '--help') return true;
-  }
-  return false;
-}
-
-/**
- * Full --help text. Sourced verbatim from src/main.go's `helpText` constant
- * in the Go reference; keep in sync when either side changes.
- */
-export const helpText = `fnclaude — claude CLI launcher with quality-of-life features
-
-Usage:
-  fnclaude [MODEL] [EFFORT] [CWD [WORKTREE]] [FLAGS...] [-- PROMPT]
-
-Magic positional words (positions 1+2 only, before any path):
-  Position 1 — model alias: opus | sonnet | haiku            → --model <alias>
-  Position 2 — effort level: low | medium | high | xhigh | max → --effort <level>
-                              (only honored when position 1 was a model alias)
-  To use a directory literally named opus/max/etc., prefix with ./
-
-Subcommand positionals (any positional slot, max one per invocation):
-  resume | res        → --resume                  (session picker)
-  continue | con      → --continue                (resume most recent)
-  fork | fk           → --resume --fork-session   (picker; fork on select)
-  Order-independent: "fnc resume opus" and "fnc opus resume" parse equivalently.
-  To use a directory literally named one of these, prefix with ./
-
-Positional paths (max 2 after magic/subcommand tokens):
-  1st remaining → cwd to launch claude in (fallback $XDG_CONFIG_HOME/fnclaude/noop)
-  2nd remaining → worktree name (same as -w <name>); see Worktree intercept below
-  3rd+ remaining → error. Use -A/--also for extra dirs.
-
-Reserved subcommands:
-  mcp [--noop]  — internal MCP server (invoked automatically by claude
-                  via injected --mcp-config; not for direct use)
-  To use a directory literally named mcp, prefix with ./
-
-fnclaude-owned flags:
-  -A, --also <dir>     additional extra-dir (repeatable; the only way to add
-                       extra dirs — positional extras no longer supported)
-      --no-tmux        suppress auto-tmux injection for this invocation
-  -h, --help           show this help
-  -v, --version        print fnclaude's version and exit
-                       (shadows claude's -v; use \`claude --version\` directly for that)
-
-Capital-letter shortcuts (translate to claude long-form flags):
-  -B → --brief                          -M → --permission-mode <mode>
-  -C → --chrome                         -P → --from-pr [value]
-  -D → --dangerously-skip-permissions   -R → --remote-control [name]
-  -F → --fork-session                   -T → --tmux [classic]
-  -G → --agent <agent>                  -V → --verbose
-  -I → --ide                            -W → --allowedTools <tools>
-
-All other claude flags pass through verbatim — run \`claude --help\` for the full
-reference. POSIX collapsing is supported (-BVC = -B -V -C); only the last flag in
-a collapsed group may take a value.
-
-Cross-cwd resume: when claude shows the resume picker and you select a session
-from a different cwd, fnclaude transparently re-launches in that cwd.
-
-Worktree intercept: -w <name> matching an existing worktree of the project repo
-swaps fnclaude's cwd to that worktree. Non-matching names pass through and the
-new worktree's name is also set as the session --name.
-
-Auto-name: when --, a prompt, and no --name/-n flag are all present, fnclaude
-generates a 1-3 word session label via Haiku. With ANTHROPIC_API_KEY set, the
-SDK is called directly; without it, fnclaude shells out to \`claude -p\` (which
-uses your subscription auth). Falls back silently to a heuristic if both fail.
-
-Config file:
-  $XDG_CONFIG_HOME/fnclaude/config.toml (or ~/.config/fnclaude/config.toml)
-  [exec.env] NAME = "value" entries are injected into claude's environment.
-
-Environment variables (override config; precedence: CLI > env > config > default):
-  ANTHROPIC_API_KEY                       direct-API auth for auto-name (else shells \`claude -p\`)
-  FNCLAUDE_NAME_MODEL                     model for auto-name (default: claude-haiku-4-5)
-  FNCLAUDE_NAME_TIMEOUT                   auto-name LLM timeout (default: 3s API / 15s CLI)
-  FNCLAUDE_QUIET_MISSING_API_KEY          deprecated no-op (warning was removed)
-  FNCLAUDE_TMUX                           never | worktree | always (default: never)
-  FNCLAUDE_HANDOFF                        never | ask | <N> seconds (default: ask)
-                                          controls noop router's proposing UX
-                                          (user-initiated project switches always
-                                          available; see README)
-  FNC_PROMPTS_DIR                         override install-dir prompts location
-                                          (default: <exe-dir>/prompts or
-                                          <exe-dir>/../share/fnclaude/prompts)
-
-Examples:
-  fnclaude                                # interactive in ~/.config/fnclaude/noop
-  fnclaude opus max ~/src/proj            # opus + max effort, launch in ~/src/proj
-  fnclaude ~/src/proj my-wt               # cwd + worktree (same as -w my-wt)
-  fnclaude ~/src/proj -A ~/src/extra      # main + extra dir (mcp/settings injected)
-  fnclaude ~/src/proj -- "fix the bug"    # auto-name from prompt
-  fnclaude -A docs/ ~/src/proj -V         # ergonomic flag form
-
-For more, see https://github.com/fnclaude/fnclaude
-`;