Back to Blog

riddlg 0.5.0 Released

riddlg 0.5.0, the local RIDDL generator, is now available.

release riddlg generator cli

riddlg 0.5.0 is now available. riddlg is the local, single-binary RIDDL toolchain — documentation and API-spec generation, AI-assisted RIDDL generation, and an MCP server, installable via Homebrew. This release includes:

What’s New

What’s New

Features

  • Rich, hierarchical documentation for every format — riddlg gen docs now emits the same rich output across all formats: pages and in-page sections mirroring your model’s hierarchy, every definition’s brief and description, per-definition and overview diagrams plus image attachments rendered as numbered figures, and front pages with a table of contents, a table of figures, and overview diagrams.
  • Four documentation formats — asciidoc, mkdocs, hugo-book, and hugo-geekdoc, selectable with -f (and -f hugo as an alias for hugo-geekdoc, the previous default). The same rich content is produced for all of them.
  • AsciiDoc builds to a website and a PDF — the AsciiDoc output now includes a Maven pom.xml, a Makefile, and a README.adoc, so make site builds an HTML website and make pdf builds a PDF book with Asciidoctor.
  • Streaming AI chat responses — the local server’s POST /ai/messages endpoint accepts "stream": true and returns an Anthropic-shaped text/event-stream, so a client (e.g. Synapify’s chat) can consume the answer as an event stream.

Bug Fixes

  • riddlg serve no longer holds its port after a model download — the model auto-download subprocess inherited the server’s listening socket, keeping the port in LISTEN after the server exited and blocking the next serve from binding. Inherited descriptors are now closed on exec, so restarts bind cleanly.

Breaking Changes

  • Environment variables renamed OSSUM_GEN_* → RIDDLG_*. Update any scripts or CI that set them — for example OSSUM_GEN_MODEL_URL becomes RIDDLG_MODEL_URL, OSSUM_GEN_MAX_TOKENS becomes RIDDLG_MAX_TOKENS.

Internal

  • The per-format documentation generators were unified behind a single shared document model, so AsciiDoc, MkDocs, and Hugo render from one source of truth.
  • Each release now auto-publishes a release announcement to the ossum.ai blog.

Install

  • macOS: brew install ossuminc/tap/riddlg
  • Linux (rpm/yum): download the .rpm from this release, or use the tarball. (deb also attached.)