OGRL Tooling · Documentation & Request for Comments

Tools for running an OGRL program.

The OGRL language is a spec. This site documents the software built on it: the ogrl CLI, the self-hosted application and its HTTP API, the integration SDK, and first-party integrations that collect live evidence from vendor systems. Design changes to these tools are proposed here as RFCs.

Application
Self-hosting the OGRL application
Run the API, job worker, and web UI locally or on AWS.
ogrl CLI
The ogrl CLI
Lint, format, import, evaluate, diff, and render OSCAL from the command line.
SDK
Integration SDK
Write, test, and package integrations that collect vendor snapshots.
Integrations
First-party integrations
Okta, GitHub, and AWS: setup, resources, and check templates.

Documentation (4)

DOC

Self-hosting the OGRL application

Operator guide for the self-hosted OGRL application: one Python ogrl server process (HTTP API, job worker, scheduler, agents) that is the sole writer to a PostgreSQL organization database, a Next.js web UI that talks to it only over HTTP, and S3-compatible…

v0.1.0 adversitydotdev/ogrl 14 min read
DOC

The ogrl CLI

ogrl is a standalone Rust binary that lints, formats, imports, bundles, evaluates, diffs, and renders OGRL repositories. It ships with ogrl_rs, a Python package that exposes the same engine.

v0.2.0 adversitydotdev/ogrl-rs 10 min read

Tooling RFCs (5)

RFC 0004

HTTP API

This RFC documents the design rationale, resource conventions, and operational workflows of the HTTP API served by ogrl. The formal route and schema contract lives in api/openapi.yaml. Open design questions are collected in Section 7.

Draft 2026-11-08 8 min read Depends on RFC 0001 ↗, RFC 0002 ↗, RFC 0003
RFC 0007

Smithy Query Sources

RFC 0006 defines query sources over a vendor's OpenAPI description. AWS publishes no OpenAPI; it publishes Smithy models for every service (aws/api-models-aws, Apache-2.0).

Draft 2026-11-21 7 min read Depends on RFC 0005, RFC 0006

Repositories (6)

CLI · Rust GitHub ↗
ogrl-rs
adversitydotdev/ogrl-rs
The ogrl CLI and ogrl_rs Python wheel: lint, format, import, evaluate, diff, and render OSCAL.
Application · Python GitHub ↗
ogrl
adversitydotdev/ogrl
Self-hosted application: HTTP API, job worker, web UI, agents, and integration host.
SDK · Python GitHub ↗
ogrl-integration-sdk
adversitydotdev/ogrl-integration-sdk
Library and CLI for writing, testing, and packaging integrations.
Integration GitHub ↗
ogrl-okta
adversitydotdev/ogrl-okta
Collects identity-provider snapshots from Okta.
Integration GitHub ↗
ogrl-github
adversitydotdev/ogrl-github
Collects source-host snapshots from GitHub.
Integration GitHub ↗
ogrl-aws
adversitydotdev/ogrl-aws
Collects cloud-account snapshots from AWS through a read-only role.