wormajs
v0.2.1
Published
A modern OpenAPI code generator - Generate type-safe API clients from OpenAPI specs
Maintainers
Readme
worma - The OpenAPI Generator for human and AI

What is worma?
worma is a universal OpenAPI code generator that works with any backend language and any frontend request library. Provide an OpenAPI spec, and worma generates:
- API calling functions — ready to import and use in your project
- TypeScript type definitions — full type safety for request/response
- In-editor documentation — hover docs, sidebar API explorer via VSCode extension
- AI Skills — structured API knowledge for coding agents (Cursor, Copilot, etc.)
Installation
npm i wormajs -DQuick Start
# Initialize configuration
npx worma init
# Generate API code
npx worma genTemplates
worma ships with pre-built templates for popular request libraries:
| Template | Library | Notes |
| -------------- | ------------ | ------------------------------------- |
| alova | alova@3 | Functional, tree-shakeable |
| alovaGlobals | alova@3 | Global Apis.xxx, migration-friendly |
| axios | axios | Most popular HTTP client |
| fetch | native fetch | Zero dependencies |
| ky | ky | Lightweight fetch wrapper |
Custom Handlebars templates are also supported.
Plugins
Built-in plugins include: aiDoc, apifox, filterApi, importType, payloadModifier, platform, rename, tagModifier.
Documentation
Please refer to the worma documentation for full details.
Migration from @alova/wormhole
npx skills add alovajs/skills --skill worma-guidelinesThen ask your coding agent: "Please migrate this project from @alova/wormhole to worma."
Join the community
We need your support
If you like worma, please give us a star! It's a recognition and encouragement for our work.
Welcome to contribute
We are honored to receive active participation from developers around the world in Issues and Discussions.
We hope to make worma a common project for everyone who is willing to participate. We encourage everyone to become a contributor to the worma community with an open and inclusive attitude. Even if you are a junior developer, as long as your ideas meet the development guidelines, please participate generously.
Effective contributions will win you a certain reputation in the worma community. Before contributing, please be sure to read the Contribution Guide in detail.
