pkg.soopen package index

brew / rank 2662

Install tbls with Homebrew, MacPorts, Nix

CI-Friendly tool to document a database. Version 1.95.0 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#tbls.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install tbls

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install tbls

MacPorts ports tree · databases/tbls/Portfile · source: api.github.com

Linux

Nixverified · 92%
nix profile install nixpkgs#tbls

nixpkgs package indexes · pkgs/by-name/tb/tbls/package.nix · source: api.github.com

overview

Package summary

CI-Friendly tool to document a database

Commands and aliases

  • tbls

history

Project history and usage

tbls is a Go command-line tool for generating, linting, and diffing database documentation in CI-friendly workflows.

Project history

The official repository was created in 2018 and describes tbls as a CI-Friendly tool to document a database. Its README highlights automatic GitHub Flavored Markdown output, multiple output formats, many supported databases, single-binary distribution, and use as a database linter.

The project grew around a repository-centered documentation workflow: add .tbls.yml or tbls.yml, run tbls doc, commit the generated schema docs, and let CI check documentation drift.

Adoption history

By 2026, official GitHub metadata showed several thousand stars and more than two hundred forks. The input package metadata lists Homebrew, MacPorts, and Nix packages, and the README documents additional installation routes including deb, RPM, Go install, Docker, aqua, and GitHub Actions.

How it is used

A typical user points tbls at a database DSN, generates Markdown documentation, and commits both the config and generated docs. The README also documents tbls diff for schema/document drift and linting rules for database quality checks.

Why package nerds care

tbls is interesting to package nerds because it treats database documentation as a reproducible CLI artifact. Its single-binary Go distribution, package-manager availability, and GitHub Actions setup make it easy to pin in CI and run alongside migrations or schema review.

Timeline

  • 2018: GitHub repository created.
  • 2021: GitHub release metadata shows the 1.53 and 1.54 series.
  • 2026: GitHub release metadata lists the 1.94 series.

Related projects

  • tbls integrates with many database backends through DSNs, including PostgreSQL, MySQL, MariaDB, SQLite, BigQuery, Cloud Spanner, Redshift, SQL Server, DynamoDB, Snowflake, MongoDB, ClickHouse, Databricks, JSON, HTTP, and GitHub-backed schema sources.

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

  • broad file, network, media, or database tool signal

Signals

  • text:database

Install behavior

  • No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
.tbls.ymltbls.yml

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix
.tbls.ymltbls.yml

executables

Installed executables

CommandKindExposureNote
tblsexecutableindexed executableDiscovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03
manager version1.95.0
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:tbls
Version1.95.0
Package managerHomebrew
Homepagehttps://github.com/k1LoW/tbls
Repositoryhttps://github.com/k1LoW/tbls
Last updated2026-07-26T00:50:33+02:00
Pulseupdated
Bottlenot recorded
Servicenone declared

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

tbls

nix profile install nixpkgs#tbls
  • normalized package name match
  • Matched by: Tbls
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/tb/tbls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
MacPorts95%

tbls

sudo port install tbls
  • normalized package name match
  • Matched by: Tbls
MacPorts ports tree · api.github.com · MacPorts ports tree: databases/tbls/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • pkg.so package database
  • pkgdb category and tag curation