@tronsfey/openapi2cli 1.0.10

package/dist/generator/template-engine.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplate = renderTemplate;
+const handlebars_1 = __importDefault(require("handlebars"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Register all helpers once at module load
+registerHelpers();
+// After build: __dirname = dist/generator/, templates are at dist/templates/
+// During dev with ts-node: __dirname = src/generator/, templates are at src/templates/
+// In both cases, templates are one level up from __dirname
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
+async function renderTemplate(templateName, context) {
+    const templatePath = path.join(TEMPLATES_DIR, templateName);
+    const source = fs.readFileSync(templatePath, 'utf-8');
+    const template = handlebars_1.default.compile(source, { noEscape: true });
+    return template(context);
+}
+function registerHelpers() {
+    handlebars_1.default.registerHelper('uppercase', (s) => s.toUpperCase());
+    handlebars_1.default.registerHelper('camelCase', (s) => s.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).replace(/^([A-Z])/, (c) => c.toLowerCase()));
+    handlebars_1.default.registerHelper('pascalCase', (s) => s.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(''));
+    // Block helper: {{#eq a "value"}}...{{else}}...{{/eq}}
+    // Must use function keyword (not arrow) so Handlebars can bind 'this' correctly
+    handlebars_1.default.registerHelper('eq', function (a, b, options) {
+        return a === b ? options.fn(this) : options.inverse(this);
+    });
+    // optionFlag(name, required, type) -> "--name <name>" | "--name [name]" | "--name"
+    handlebars_1.default.registerHelper('optionFlag', (name, required, type) => {
+        if (type === 'boolean')
+            return `--${name}`;
+        const brackets = required ? `<${name}>` : `[${name}]`;
+        return `--${name} ${brackets}`;
+    });
+    handlebars_1.default.registerHelper('join', (arr, sep) => Array.isArray(arr) ? arr.join(sep) : '');
+    // Check if an array has items
+    handlebars_1.default.registerHelper('hasItems', (arr) => Array.isArray(arr) && arr.length > 0);
+    // jsString(s) -> JSON.stringify(s)  e.g. jsString("it's") -> '"it\'s"'
+    // Use this whenever a value is embedded inside a TypeScript string literal in generated code,
+    // to safely handle single quotes, double quotes, backslashes, and Unicode characters.
+    handlebars_1.default.registerHelper('jsString', (s) => JSON.stringify(String(s ?? '')));
+    // subcommandHelpText(subcommand) -> JSON string with tree-formatted body/response fields,
+    // or empty string if there is nothing to display.
+    handlebars_1.default.registerHelper('subcommandHelpText', (subcommand) => {
+        const lines = [];
+        const pad = (s, n) => s.padEnd(n);
+        // --- request body ---
+        const rb = subcommand['requestBody'];
+        if (rb?.fields?.length) {
+            lines.push('');
+            lines.push(`Body (--data JSON, ${rb.required ? 'required' : 'optional'}):`);
+            rb.fields.forEach((f, i) => {
+                const prefix = i === rb.fields.length - 1 ? '  └─' : '  ├─';
+                const req = f.required ? 'required' : 'optional';
+                const enumHint = f.enum?.length ? `  choices: ${f.enum.join(' | ')}` : '';
+                lines.push(`${prefix} ${pad(f.name, 18)}${pad(f.type, 12)}${pad(req, 10)}${f.description}${enumHint}`);
+            });
+        }
+        // --- 2xx responses ---
+        const responses = (subcommand['responses'] ?? {});
+        for (const [code, resp] of Object.entries(responses)) {
+            if (!code.startsWith('2') || !resp.fields?.length)
+                continue;
+            lines.push('');
+            lines.push(`Response ${code} (${resp.description ?? ''}):`);
+            resp.fields.forEach((f, i) => {
+                const prefix = i === resp.fields.length - 1 ? '  └─' : '  ├─';
+                lines.push(`${prefix} ${pad(f.name, 18)}${pad(f.type, 12)}${f.description}`);
+            });
+        }
+        return lines.length ? JSON.stringify(lines.join('\n')) : '';
+    });
+    // pad(str, n) -> str padded to n chars with spaces (for aligned help output)
+    handlebars_1.default.registerHelper('pad', (s, n) => String(s ?? '').padEnd(n));
+    // sampleResponseJson(subcommand) -> pretty-printed sample JSON from the first 2xx response
+    // schema, or empty string when no schema fields are available.
+    handlebars_1.default.registerHelper('sampleResponseJson', (subcommand) => {
+        function sampleValue(name, type) {
+            if (type === 'integer' || type === 'number')
+                return 1;
+            if (type === 'boolean')
+                return true;
+            if (type === 'array')
+                return [];
+            if (type === 'object')
+                return {};
+            const lower = name.toLowerCase();
+            if (lower === 'id' || lower.endsWith('_id') || lower.endsWith('id'))
+                return 1;
+            if (lower.includes('email'))
+                return 'user@example.com';
+            if (lower.includes('name') || lower === 'title')
+                return 'example';
+            if (lower.includes('url') || lower.includes('href') || lower.includes('link'))
+                return 'https://example.com';
+            if (lower.includes('date') || lower.includes('time') || lower.endsWith('_at'))
+                return '2024-01-01T00:00:00Z';
+            if (lower.includes('status') || lower.includes('state'))
+                return 'active';
+            if (lower.includes('count') || lower.includes('total') || lower.includes('num'))
+                return 1;
+            if (lower.includes('description') || lower.includes('desc') || lower.includes('summary'))
+                return 'A brief description.';
+            return 'example';
+        }
+        const responses = (subcommand['responses'] ?? {});
+        for (const [code, resp] of Object.entries(responses)) {
+            if (!code.startsWith('2') || !resp.fields?.length)
+                continue;
+            const obj = {};
+            for (const f of resp.fields)
+                obj[f.name] = sampleValue(f.name, f.type);
+            return resp.isArray ? JSON.stringify([obj], null, 2) : JSON.stringify(obj, null, 2);
+        }
+        return '';
+    });
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/generator/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/generator/template-engine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fse = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const oas_parser_1 = require("./parser/oas-parser");
+const schema_analyzer_1 = require("./analyzer/schema-analyzer");
+const command_generator_1 = require("./generator/command-generator");
+const program = new commander_1.Command();
+program
+    .name('openapi2cli')
+    .description('Generate a typed CLI from an OpenAPI 3.x specification')
+    .version('1.0.0')
+    .requiredOption('--oas <path-or-url>', 'Path or URL to the OpenAPI spec file')
+    .requiredOption('--name <cli-name>', 'Name for the generated CLI tool')
+    .requiredOption('--output <dir>', 'Output directory for the generated project')
+    .option('--overwrite', 'Overwrite output directory if it exists', false)
+    .action(async (opts) => {
+    await run(opts);
+});
+program.parseAsync(process.argv).catch((err) => {
+    console.error(chalk_1.default.red('Fatal:'), err.message);
+    process.exit(1);
+});
+async function run(opts) {
+    const outputDir = path.resolve(process.cwd(), opts.output);
+    // Pre-flight: check output directory
+    if (await fse.pathExists(outputDir)) {
+        if (!opts.overwrite) {
+            console.error(chalk_1.default.red('Error:'), `Output directory already exists: ${outputDir}`);
+            console.error('Use --overwrite to replace it.');
+            process.exit(1);
+        }
+        await fse.remove(outputDir);
+    }
+    // Step 1: Parse OAS
+    const parseSpinner = (0, ora_1.default)('Parsing OpenAPI spec...').start();
+    let api;
+    try {
+        api = await (0, oas_parser_1.parseOAS)(opts.oas);
+        parseSpinner.succeed(chalk_1.default.green(`Parsed: ${api.info.title} v${api.info.version}`));
+    }
+    catch (err) {
+        parseSpinner.fail('Failed to parse OpenAPI spec');
+        throw err;
+    }
+    // Step 2: Analyze schema
+    const analyzeSpinner = (0, ora_1.default)('Analyzing schema...').start();
+    const structure = (0, schema_analyzer_1.analyzeSchema)(api, opts.name);
+    const groupCount = structure.groups.length;
+    const flatCount = structure.flatCommands.length;
+    const summary = [
+        groupCount > 0 ? `${groupCount} command group(s)` : '',
+        flatCount > 0 ? `${flatCount} flat command(s)` : '',
+    ].filter(Boolean).join(', ');
+    analyzeSpinner.succeed(chalk_1.default.green(`Found ${summary}`));
+    // Print any naming warnings collected during analysis
+    if (structure.warnings.length > 0) {
+        console.log('');
+        console.log(chalk_1.default.yellow('  ⚠  规范性警告 (建议修复 OpenAPI 定义):'));
+        for (const w of structure.warnings) {
+            console.log(chalk_1.default.yellow(`     ${w}`));
+        }
+        console.log('');
+    }
+    // Step 3: Generate project files
+    const genSpinner = (0, ora_1.default)('Generating project files...').start();
+    let files;
+    try {
+        files = await (0, command_generator_1.generateProject)(structure);
+        genSpinner.succeed(chalk_1.default.green(`Generated ${files.length} file(s)`));
+    }
+    catch (err) {
+        genSpinner.fail('Failed to generate project files');
+        throw err;
+    }
+    // Step 4: Write files to output directory
+    const writeSpinner = (0, ora_1.default)(`Writing to ${outputDir}...`).start();
+    for (const file of files) {
+        const dest = path.join(outputDir, file.relativePath);
+        await fse.outputFile(dest, file.content, 'utf-8');
+    }
+    // Make the bin file executable
+    const binPath = path.join(outputDir, 'bin', opts.name);
+    if (await fse.pathExists(binPath)) {
+        await fse.chmod(binPath, 0o755);
+    }
+    writeSpinner.succeed(chalk_1.default.green('Done!'));
+    console.log('');
+    console.log(chalk_1.default.bold('Next steps:'));
+    console.log(chalk_1.default.cyan(`  cd ${opts.output}`));
+    console.log(chalk_1.default.cyan('  npm install'));
+    console.log(chalk_1.default.cyan('  npm run build'));
+    console.log(chalk_1.default.cyan(`  ./${path.join('bin', opts.name)} --help`));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/parser/oas-parser.d.ts

@@ -0,0 +1,3 @@
+import { OpenAPIV3 } from 'openapi-types';
+export declare function parseOAS(input: string): Promise<OpenAPIV3.Document>;
+//# sourceMappingURL=oas-parser.d.ts.map

package/dist/parser/oas-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oas-parser.d.ts","sourceRoot":"","sources":["../../src/parser/oas-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAyBzE"}

package/dist/parser/oas-parser.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOAS = parseOAS;
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+async function parseOAS(input) {
+    const isUrl = /^https?:\/\//.test(input);
+    let source;
+    if (isUrl) {
+        source = input;
+    }
+    else {
+        source = path.resolve(process.cwd(), input);
+        if (!fs.existsSync(source)) {
+            throw new Error(`OAS file not found: ${source}`);
+        }
+    }
+    // dereference() resolves all $ref nodes and validates the spec against OAS JSON Schema
+    const api = await swagger_parser_1.default.dereference(source);
+    // Guard: only support OAS 3.x (not Swagger 2.0)
+    if (!api.openapi || !api.openapi.startsWith('3.')) {
+        const version = api.openapi ?? api['swagger'];
+        throw new Error(`Unsupported spec version: "${version}". Only OpenAPI 3.x is supported.`);
+    }
+    return api;
+}
+//# sourceMappingURL=oas-parser.js.map

package/dist/parser/oas-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oas-parser.js","sourceRoot":"","sources":["../../src/parser/oas-parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,4BAyBC;AA9BD,iFAAwD;AAExD,2CAA6B;AAC7B,uCAAyB;AAElB,KAAK,UAAU,QAAQ,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,MAAc,CAAC;IACnB,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,uFAAuF;IACvF,MAAM,GAAG,GAAG,MAAM,wBAAa,CAAC,WAAW,CAAC,MAAM,CAAuB,CAAC;IAE1E,gDAAgD;IAChD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAK,GAA0C,CAAC,SAAS,CAAC,CAAC;QACtF,MAAM,IAAI,KAAK,CACb,8BAA8B,OAAO,mCAAmC,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/templates/README.md.hbs

@@ -0,0 +1,197 @@
+English | [中文](./README.zh.md)
+
+# {{structure.name}}
+
+{{structure.description}}
+
+| | |
+|---|---|
+| **Base URL** | `{{structure.baseUrl}}` |
+| **Version** | `{{structure.version}}` |
+| **Auth** | {{#eq structure.authConfig.type "bearer"}}Bearer token (`{{structure.authConfig.envVar}}`){{/eq}}{{#eq structure.authConfig.type "apiKey"}}API key (`{{structure.authConfig.envVar}}`){{/eq}}{{#eq structure.authConfig.type "basic"}}Basic auth (`{{structure.authConfig.envVar}}`){{/eq}}{{#eq structure.authConfig.type "none"}}None{{/eq}} |
+
+## Quick Start
+
+```bash
+npm install && npm run build && npm link
+```
+
+{{#eq structure.authConfig.type "bearer"}}
+```bash
+export {{structure.authConfig.envVar}}=your-token-here
+```
+{{/eq}}
+{{#eq structure.authConfig.type "apiKey"}}
+```bash
+export {{structure.authConfig.envVar}}=your-api-key
+```
+{{/eq}}
+{{#eq structure.authConfig.type "basic"}}
+```bash
+export {{structure.authConfig.envVar}}=username:password
+```
+{{/eq}}
+
+```
+$ {{structure.name}} --help
+Usage: {{structure.name}} [options] [command]
+
+{{structure.description}}
+
+Commands:
+{{#each structure.groups}}  {{pad name 26}}{{description}}
+{{/each}}{{#each structure.flatCommands}}  {{pad name 26}}{{description}}
+{{/each}}
+Options:
+  --endpoint <url>       Override the base API URL (default: "{{structure.baseUrl}}")
+  --format <format>      Output format (choices: "json", "yaml", "table", default: "json")
+  --verbose              Enable verbose request logging
+  -V, --version          output the version number
+  -h, --help             display help for command
+```
+
+---
+
+## Commands
+
+{{#each structure.groups}}
+### `{{../structure.name}} {{name}}`
+
+{{description}}
+
+```
+$ {{../../structure.name}} {{name}} --help
+Usage: {{../../structure.name}} {{name}} [options] [command]
+
+{{description}}
+
+Commands:
+{{#each subcommands}}  {{pad name 26}}{{description}}
+{{/each}}
+Options:
+  -h, --help             display help for command
+```
+
+{{#each subcommands}}
+#### `{{../../structure.name}} {{../name}} {{name}}`
+
+{{description}} — `{{uppercase method}} {{path}}`
+
+```
+$ {{../../../structure.name}} {{../../name}} {{name}} --help
+Usage: {{../../../structure.name}} {{../../name}} {{name}} [options]
+
+{{description}}
+
+Options:
+{{#each options}}  {{pad (optionFlag name required type) 28}}{{description}}{{#if defaultValue}} (default: {{defaultValue}}){{/if}}{{#if enum}} (choices: {{join enum ", "}}){{/if}}
+{{/each}}  -h, --help                     display help for command
+```
+
+**Example:**
+
+```bash
+$ {{../../../structure.name}} {{../../name}} {{name}}{{#each options}}{{#if required}} --{{name}} <{{name}}>{{/if}}{{/each}}
+```
+
+{{#if (sampleResponseJson this)}}
+**Response:**
+
+```json
+{{sampleResponseJson this}}
+```
+{{/if}}
+{{#if (subcommandHelpText this)}}
+**Schema:**
+```
+{{subcommandHelpText this}}
+```
+{{/if}}
+
+---
+{{/each}}
+{{/each}}
+{{#if (hasItems structure.flatCommands)}}
+## Top-Level Commands
+
+Untagged operations registered directly on the CLI root.
+
+{{#each structure.flatCommands}}
+### `{{../structure.name}} {{name}}`
+
+{{description}} — `{{uppercase method}} {{path}}`
+
+```
+$ {{../../structure.name}} {{name}} --help
+Usage: {{../../structure.name}} {{name}} [options]
+
+{{description}}
+
+Options:
+{{#each options}}  {{pad (optionFlag name required type) 28}}{{description}}{{#if defaultValue}} (default: {{defaultValue}}){{/if}}{{#if enum}} (choices: {{join enum ", "}}){{/if}}
+{{/each}}  -h, --help                     display help for command
+```
+
+**Example:**
+
+```bash
+$ {{../../structure.name}} {{name}}{{#each options}}{{#if required}} --{{name}} <{{name}}>{{/if}}{{/each}}
+```
+
+{{#if (sampleResponseJson this)}}
+**Response:**
+
+```json
+{{sampleResponseJson this}}
+```
+{{/if}}
+{{#if (subcommandHelpText this)}}
+**Schema:**
+```
+{{subcommandHelpText this}}
+```
+{{/if}}
+
+---
+{{/each}}
+{{/if}}
+
+## Global Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--endpoint <url>` | Override the base API URL | `{{structure.baseUrl}}` |
+| `--format <format>` | Output format | `json` (choices: `json`, `yaml`, `table`) |
+| `--verbose` | Log HTTP method + URL before each request | `false` |
+
+## Request Body
+
+For `POST`, `PUT`, `PATCH` commands use `--data` to pass the request body:
+
+```bash
+# Inline JSON
+{{structure.name}} <group> <command> --data '{"key": "value"}'
+
+# From a file
+{{structure.name}} <group> <command> --data @payload.json
+```
+
+## Output Formats
+
+```bash
+# Default: pretty-printed JSON
+{{structure.name}} <group> <command> [options]
+
+# Table view (great for arrays)
+{{structure.name}} <group> <command> [options] --format table
+
+# Pipe to jq for filtering
+{{structure.name}} <group> <command> [options] | jq '.items[]'
+
+# Save to file
+{{structure.name}} <group> <command> [options] > result.json
+```
+
+---
+
+_Generated by [openapi2cli](https://github.com/tronsfey928/openapi2cli) from OpenAPI spec v{{structure.version}}._