A federation toolchain for API specifications — every standard talks to every other, and every downstream tool (SDK gen, docs, diff, load test, mock data) reads the same canonical input regardless of source format.

• Spec interop — OpenAPI 3, AsyncAPI 3, TypeSpec, Protobuf, Postman, JSON Schema. A graph-routed dispatcher chains converters automatically: register one edge into OpenAPI 3 and every other format unlocks combinatorially.
• Standalone HTML docs for any input — ir docs api.proto --out docs.html (renders via Scalar).
• Cross-family diff — ir spec diff before.proto --after after.postman_collection.json produces breaking / non-breaking classification via api-smart-diff.
• Native client SDKs in Go, Kotlin, Swift, TypeScript — idiomatic per language, not transpiled from a TS base.
• Spec-driven load testing — typed k6 scripts with defineLoadTest/flow().step() chaining, no string-templating.
• Spec discovery from traffic — reverse-engineer an OpenAPI 3.1 spec from observed HTTP, either as a library or a Chrome extension.
• Drop-in plugins for @hey-api/openapi-ts — faker factories, oRPC clients, route maps, typia validators, and the k6 generator.

All OpenAPI consumers share one normalization layer (@hey-api's IR), so 2.0 / 3.0 / 3.1 inputs land in the same shape. Per-target generators (@ir-kit/openapi-{go,kotlin,swift,typescript}, @ir-kit/k6-gen) expose a pure generate({ spec, output }) and don't require a hey-api plugin runner at the call site. Everything is reachable through the unified ir CLI or directly as a programmatic API per package.

ir-kit ships six Agent Skills that teach AI coding agents — Claude Code, Cursor, GitHub Copilot, Codex, Cline, Windsurf, and ~50 more — how to drive these packages without you re-explaining the API each session.

# Install all skills (auto-detects your installed agents)
npx skills add ir-kit/ir-kit

# Pick specific skills
npx skills add ir-kit/ir-kit --skill k6-loadtest --skill openapi-sdk

# Install globally for every project
npx skills add ir-kit/ir-kit -g

Install the ir-kit Agent Skills from https://github.com/ir-kit/ir-kit into this project so you can use them in future sessions. Run npx skills add ir-kit/ir-kit — it auto-detects whichever agent I'm using and writes each SKILL.md to the right location. If that command isn't available, clone the repo and copy skills/<name>/SKILL.md into the skill directory for your agent (Claude Code: .claude/skills/<name>/SKILL.md). Then confirm these six are installed: k6-loadtest, openapi-sdk, openapi-from-traffic, asyncapi-typescript, fn-schema, heyapi-plugin-author.

This repo is also a Claude Code plugin — .claude-plugin/plugin.json + marketplace.json are committed at the root, so adding the repo as a marketplace in Claude Code surfaces all six skills automatically.

flowchart LR
  postman["Postman"] --> hub
  proto["Protobuf"] --> hub
  tsp["TypeSpec"] --> hub
  aspec["AsyncAPI"] --> hub
  ts["TS source"] --> fn["fn-schema"] -.-> hub
  traffic["HTTP traffic"] --> recon["openapi-recon · glean"] -.-> hub

  hub["OpenAPI 3<br/>(federation hub)"]

  hub --> docs["spec-docs<br/>(Scalar HTML)"]
  hub --> diff["spec-diff<br/>(api-smart-diff)"]
  hub --> conv["spec-convert<br/>→ postman / proto / typespec / json-schema"]
  hub --> native["openapi-{go,kotlin,swift,typescript}"]
  hub --> heyplugins["@hey-api plugins<br/>(faker · orpc · paths · typia · k6)"]
  hub --> k6tk["k6-toolkit"] --> k6gen["k6-gen"] --> k6fw["@ir-kit/k6"]

  aspec --> asyncts["asyncapi-typescript"]

@ir-kit/spec-convert graph-routes between every supported format — register a single (X → openapi3) and (openapi3 → X) edge and every other pair becomes reachable automatically. Internal building blocks (codegen-core, openapi, openapi-tools, asyncapi-core, schema) are listed under Shared primitives below — you usually consume one of the higher-level packages instead.

The package list above is auto-generated from each package.json's description field, with categories driven by scripts/sync-readme.mjs. The lefthook pre-commit hook keeps it current; run pnpm sync:readme manually if needed.

Three @hey-api/openapi-ts plugins ship in lockstep via Changesets' fixed config (openapi-ts-faker, openapi-ts-orpc, openapi-ts-typia) — bumping one bumps all three. openapi-ts-paths and openapi-ts-k6 version independently, as does everything else.

pnpm install
pnpm build
pnpm typecheck
pnpm test

Releases run on Changesets:

pnpm changeset           # describe a change
pnpm version-packages    # bump versions + write CHANGELOGs (locally)
pnpm release             # build + publish via changeset publish

In CI, pushing a .changeset/*.md to main opens a "Version Packages" PR; merging that PR publishes to npm.

Every PR also triggers a pkg.pr.new preview build — install any package at the PR's commit SHA without waiting for a release:

pnpm add https://pkg.pr.new/@ir-kit/openapi-tools@<commit-sha>