LLMSchema vs tbls
LLMSchema
github.comtbls
github.comSide by side
| Figure | LLMSchema | tbls |
|---|---|---|
| Price from | Free | Free |
| Free plan | Yes | Yes |
| Free trial | — | — |
| Open source | — | — |
| Windows | Yes | Yes |
| macOS | Yes | Yes |
| Linux | Yes | Yes |
| Self-hosted | Yes | Yes |
| Plans published | 1 | 1 |
| Spec score · Database Documentation Tools | 8.1 (#11) | 8.2 (#9) |
| License | The repository identifies the project as MIT licensed. | The software is released under the MIT License and permits use, copying, modification, publication, distribution and sublicensing subject to its notice requirement. |
| Maker | The repository is published under the GitHub account tordrt, whose profile name is Tord. | The repository owner and copyright holder is Ken'ichiro Oyama. |
| Output formats | It can produce one portable Markdown document or an overview with a separate Markdown file for each table. | tbls can output Markdown, DOT, PlantUML, Mermaid, SVG, PNG, JPG, JSON, YAML, Excel, and configuration files. |
| Purpose | LLMSchema generates database schema documentation for LLMs and AI agents. | tbls is a CI-friendly tool written in Go for documenting databases. |
| Supported databases | It extracts schemas from PostgreSQL, MySQL, and SQLite. | Documented data sources include PostgreSQL, MySQL, MariaDB, SQLite, BigQuery, Cloud Spanner, Redshift, SQL Server, DynamoDB, Snowflake, MongoDB, ClickHouse and Databricks. |
Plans
In their own words
LLMSchema
LLMSchema is free, MIT-licensed software that generates database schema documentation for LLMs and AI agents. It extracts relational schemas from PostgreSQL, MySQL, and SQLite, then documents tables, columns, types, indexes, constraints, and relationships in Markdown. The default output is one portable Markdown document. An alternate layout creates an overview plus a separate Markdown file for each table. Users can include selected tables or exclude tables from the generated documentation. LLMSchema is available as a command-line tool and a Go library, with installation instructions for Go and a quick install script for macOS and Linux. The README shows adding schema generation to a Makefile or migration script to keep documentation current. It also suggests pointing a coding agent to the schema files from AGENTS.md, CLAUDE.md, or an equivalent instruction file. The project is self-hosted and listed for Linux, macOS, and Windows. Its maker positions it for development databases and says not to rely on it for production-critical documentation.
tbls
tbls is a command-line tool for documenting databases and checking their schemas. It generates GitHub Flavored Markdown and can export schema information in formats including DOT, PlantUML, Mermaid, SVG, PNG, JPG, JSON, YAML, Excel, and configuration files. Its configurable lint rules can require column comments or set column-count limits. The `diff` command compares a database schema with generated documentation or another database, while `coverage` measures documentation for descriptions and comments. Documented data sources include PostgreSQL, MySQL, MariaDB, SQLite, BigQuery, Cloud Spanner, Amazon Redshift, SQL Server, Azure SQL, Microsoft Fabric Warehouse, DynamoDB, Snowflake, MongoDB, ClickHouse, Databricks, JSON, HTTP, and GitHub. Docker and a GitHub Action are documented for CI use, and external drivers can extend database support. It runs on Linux, macOS, and Windows, or in a self-hosted setup. The listed plan is free under the MIT License. SQL Server requires version 2017 or later and database compatibility level 110 or higher.