Swax

Swax is a tool for building traceability graphs of API endpoint dependencies from OpenAPI / Swagger specifications, using a two-pass LLM analysis. Given a spec repository, it infers which API paths depend on which other paths and persists the result as a deterministic graph.

Status: Alpha. The init, discover, and plan commands are the currently implemented surface.

What you can do

• Initialize a project from a remote spec repository (swax init).
• Discover the API dependency graph via a two-pass LLM analysis (swax discover).
• Plan testing impact from spec changes with an LLM-generated Markdown report (swax plan).

Where to go next

• Installation — set up the tool.
• Configuration — .env, .swax/config.yml.
• Quickstart — init → discover → plan walkthrough.
• Commands reference — full CLI surface.
• Architecture overview — cells, layers, dependency graph.

Project layout

.swax/
  config.yml          # written by `swax init`
  traceability.yml    # written by `swax discover`
<download_path>/      # the copied specifications

License

BSD-3-Clause. See LICENSE in the repository root.