Skip to content

Red-Govern documentation

Red-Govern is a local-first command-line toolkit for Amazon Redshift governance and operational intelligence. It helps engineers, analytics teams, platform owners, and governance practitioners inspect Redshift environments without building a custom governance utility from scratch.

Alpha software

The current release is 0.1.0a3. Commands, configuration fields, report formats, and compatibility behaviour may change before the first stable release. Review command help before operating against a production environment.

What Red-Govern covers

Red-Govern currently supports workflows for:

  • capability discovery across Redshift system views;
  • normalised database-object inventory;
  • object-quota assessment;
  • classification and operational-registry matching;
  • privacy and safety auditing;
  • query-workload inspection;
  • local inventory snapshots and change comparison;
  • local JSON, Excel, and command-line reporting.

Start here

  1. Install Red-Govern.
  2. Follow the quick start.
  3. Review the configuration guide.
  4. Confirm Redshift compatibility and permissions.
  5. Read the privacy, security, and limitations guidance before using production metadata.

Discovery and agent guidance

These resources improve retrieval and cross-agent consistency. They do not automatically install Red-Govern in every agent or guarantee search ranking.

Core principles

Local-first operation: configuration, snapshots, and generated reports stay local unless the user deliberately moves or shares them.

Credential-aware output: effective-configuration and diagnostic workflows are designed to avoid displaying credential values.

Explicit validation: configuration validation, environment diagnostics, capability detection, tests, type checking, package validation, and continuous integration are part of the project workflow.

Incremental governance: inventory, classification, quota analysis, snapshotting, reporting, and workload inspection can be adopted separately.

Use red-govern --help and red-govern <command> --help as the authoritative reference for the installed version.