openapi-to-typescript — Claude Code plugin: overview and install
openapi-to-typescript turns OpenAPI 3.0 JSON and YAML schemas into TypeScript interfaces and type guards. Runs during API integration tasks to create strict contract typings.
MIT ★ 2,707 updated 2026-03-05
/plugin marketplace add softaworks/agent-toolkit
/plugin install openapi-to-typescript@agent-toolkitWhat openapi-to-typescript does
This plugin converts OpenAPI 3.0 contracts formatted as JSON or YAML into TypeScript declarations. It produces interfaces alongside type guards for runtime payload verification. All logic lives in the skills/openapi-to-typescript skill.
Input must adhere strictly to OpenAPI 3.0 specs, meaning the tool will fail on alternative API definitions. The code comes from the softaworks/agent-toolkit repository under the MIT license.
What it helps with
- generate TypeScript interfaces from an OpenAPI 3.0 specification
- build runtime type guards for API payloads
- parse JSON and YAML endpoint definitions into TypeScript types
Example prompts for the agent
- Convert our
openapi.yamlfile into TypeScript types and type guards - Generate TypeScript interfaces from the
api-spec.jsoncontract - Build client type guards based on the OpenAPI 3.0 schema
How to install openapi-to-typescript
Plugin marketplace
/plugin marketplace add softaworks/agent-toolkit/plugin install openapi-to-typescript@agent-toolkitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about openapi-to-typescript
How to install openapi-to-typescript in Claude Code?
First add the marketplace with /plugin marketplace add softaworks/agent-toolkit, then install the plugin by running /plugin install openapi-to-typescript@agent-toolkit.
What does openapi-to-typescript do?
It parses OpenAPI 3.0 definitions in JSON or YAML format to produce TypeScript interfaces and type guards.
Which file formats are supported by openapi-to-typescript?
The plugin handles OpenAPI 3.0 specifications stored as either JSON or YAML.
Source text
openapi-to-typescript · MIT
Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. Use when generating types from OpenAPI or creating API interfaces. Skills: skills/openapi-to-typescript
© softaworks · MIT · softaworks/agent-toolkit