Function createProgram

src/cli.ts:693–3586

(BUILTIN_CLIS: string, USER_CLIS: string)

}

export function createProgram(BUILTIN_CLIS: string, USER_CLIS: string): Command {
  const program = new Command();
  // enablePositionalOptions: prevents parent from consuming flags meant for subcommands;
  // prerequisite for passThroughOptions to forward --help/--version to external binaries
  program
    .name('opencli')
    .description('Make any website your CLI. Zero setup. AI-powered.')
    .version(PKG_VERSION)
    .option('--profile <name>', 'Chrome profile/context alias for Browser Bridge commands')
    .enablePositionalOptions();

  // ── Built-in: list ────────────────────────────────────────────────────────

  program
    .command('list')
    .description('List all available CLI commands')
    .option('-f, --format <fmt>', 'Output format: table, json, yaml, md, csv', 'table')
    .action((opts) => {
      const registry = getRegistry();
      const commands = [...new Set(registry.values())].sort((a, b) => fullName(a).localeCompare(fullName(b)));
      const fmt = opts.format;
      const isStructured = fmt === 'json' || fmt === 'yaml';

      if (fmt !== 'table') {
        const rows = isStructured
          ? commands.map(serializeCommand)
          : commands.map(c => ({
              command: fullName(c),
              site: c.site,
              name: c.name,
              aliases: c.aliases?.join(', ') ?? '',
              description: c.description,
              access: c.access,
              strategy: strategyLabel(c),
              browser: !!c.browser,
              args: formatArgSummary(c.args),
            }));
        renderOutput(rows, {
          fmt,
          columns: ['command', 'site', 'name', 'aliases', 'description', 'access', 'strategy', 'browser', 'args',
                     ...(isStructured ? ['columns', 'domain'] : [])],
          title: 'opencli/list',
          source: 'opencli list',
        });
        return;
      }

      // Table (default) — grouped by adapter kind (app vs site), then by site name.
      // classifyAdapter() reads the `domain` field: DNS-style domains are sites;
      // localhost/loopback endpoints and bare app names are apps.
      const appsBySite = new Map<string, CliCommand[]>();
      const sitesBySite = new Map<string, CliCommand[]>();
      for (const cmd of commands) {
        const target = classifyAdapter(cmd.domain) === 'app' ? appsBySite : sitesBySite;
        const g = target.get(cmd.site) ?? [];
        g.push(cmd);
        target.set(cmd.site, g);
      }