---

name: api-docs-gen
description: Auto-generate OpenAPI specs and docs from code

---

API Documentation Generator

Automatically generate comprehensive API documentation from your source code.

Supported Frameworks

• Next.js App Router (route.ts files)
• Express.js
• FastAPI (Python)
• Gin (Go)
• Axum (Rust)

What It Generates

1. OpenAPI 3.1 Specification — Complete schema with types, examples, and descriptions
2. Interactive Docs — Swagger UI or Redoc HTML page
3. Client Types — TypeScript interfaces for all request/response shapes
4. cURL Examples — Ready-to-use commands for every endpoint
5. Postman Collection — Import-ready JSON

Usage (illustrative custom-wrapper commands)

These are not built-in Claude Code subcommands. They require a custom wrapper; consult the wrapper's documentation before use.

# Scan and generate docs
claude api-docs ./app/api

# Generate with specific format
claude api-docs ./app/api --format openapi --output docs/api.yaml

# Generate TypeScript client types
claude api-docs ./app/api --types --output lib/api-types.ts

Smart Detection

The generator understands:

• Zod schemas → JSON Schema
• TypeScript types → Schema definitions
• JSDoc comments → Descriptions
• HTTP status codes → Response variants
• Middleware → Auth requirements