oxide-gen 0.1.0

Spec-to-crate generator for Rust Oxide. Generates Rust clients, CLI commands, SKILL.md, and MCP server configs from OpenAPI, GraphQL, and gRPC specs.
Documentation

oxide-gen — Spec-to-Crate Generator

oxide-gen ingests an API specification (OpenAPI 3.x, GraphQL SDL, or a .proto file) and produces a self-contained Rust crate consisting of:

  • Type-safe Rust structs / enums for the spec's data models.
  • A reqwest-based asynchronous client (for OpenAPI and GraphQL) or a tonic-shaped scaffold (for gRPC) with one method per operation.
  • A clap CLI that exposes every operation as a subcommand.
  • A SKILL.md file with YAML frontmatter for Claude Code.
  • An mcp.json file describing the CLI as MCP-callable tools.
  • A module.json manifest that the [oxide_k] kernel can discover and register as a module.

The crate exposes three layers:

  • [parsers] — spec format ↔ [ir::ApiSpec].
  • [emit] — [ir::ApiSpec] → on-disk artifacts.
  • [generate_from_path] — convenience entry point that auto-detects the spec format from the file extension and runs the full pipeline.