worma - The OpenAPI Generator for human and AI
July 10, 2026 · View on GitHub
One OpenAPI spec. Code for developers, knowledge for AI.
worma is a universal OpenAPI code generator that simultaneously produces API calling code, TypeScript types, documentation, and AI Skills — for both humans and coding agents.
Key Features
🤖 AI Skill Generation
Auto-generate Skills-compliant API documentation that enables coding agents (Cursor, Copilot, Claude Code, Windsurf, etc.) to call your APIs accurately — correct function names, parameters, and import paths every time.
🧩 Four Outputs from One Source
One OpenAPI spec generates:
- API calling functions for developers to import directly
- TypeScript type definitions for type safety
- In-editor documentation via VSCode extension
- AI Skills for coding agents to read
🔌 Multi-Request-Library + Custom Templates
Built-in templates for Alova, Axios, Fetch, and Ky. Switch request libraries with a single config change. Full Handlebars-based custom template support.
📝 In-Editor API Docs
Install the VSCode extension to view complete API documentation on hover — parameter tables, response structures, and examples — even in plain JavaScript projects.
Quick Start
# Install worma for your coding agent
npx skills add alovajs/skills --skill worma-guidelines
# Or install the CLI package directly
npm i wormajs -D
npx worma init
# Edit worma.config.js with your OpenAPI URL, then:
npx worma gen