k1LoW/tbls

Health v2 · maintenance only

Adoption not part of the score

4329 stars · 209 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

tbls is a CI-friendly command-line tool written in Go that automatically generates database documentation in GFM/Markdown and other formats, including ER diagrams. It supports many databases (PostgreSQL, MySQL, SQLite, BigQuery, Spanner, DynamoDB, and more) and can also lint database schemas and diff documentation against the live database.

Use cases

• generate database schema documentation automatically
• document a postgres database as markdown
• create ER diagrams from a database schema
• lint database schema in CI
• diff database schema against documentation
• keep database docs up to date in continuous integration
• generate schema docs for mysql or bigquery

When to choose

• you want automated, always-fresh database documentation generated in CI
• you need ER diagrams and schema docs across many database engines
• you prefer a single-binary tool with no runtime dependencies

When to avoid

• you need a hosted or GUI-based data catalog solution
• your database is not among the supported data sources
• you want hand-authored, richly formatted documentation rather than generated output

Facets

cli-tool · maturity active

documentation database linter cli markdown developer-tools databases documentation developer-tools windows cli go database-schema er-diagram ci-friendly schema-documentation database-linting single-binary devops linux macos docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="k1LoW/tbls")