worma - The OpenAPI Generator for human and AI

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

Documentation

• Full Documentation
• Quick Start Guide
• Migration from @alova/wormhole
• Plugin System

Changelog

Changelog

Contributors

LICENSE

MIT