thomvaill/log4brains

Health v2 · maintenance only

Adoption not part of the score

1569 stars · 114 forks observed · 2026-08-28

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

Log4brains is a docs-as-code tool for managing Architecture Decision Records (ADRs) written in Markdown within your git repository. It provides an interactive CLI for creating ADRs, local preview with hot reload, and static site generation to publish a searchable ADR knowledge base.

Use cases

• manage architecture decision records as markdown files in git
• publish ADRs as a static documentation website
• create ADRs interactively from the command line
• build a searchable knowledge base of technical decisions
• onboard new developers with a timeline of past decisions
• review architecture decisions via pull requests

When to choose

• your team wants a docs-as-code ADR workflow integrated with git
• you need to publish ADRs to GitHub/GitLab Pages or S3
• you work in a Node.js/TypeScript project and want an npm-based tool
• you want flexible markdown structure without enforced file numbering

When to avoid

• you need a GUI-first ADR editing experience
• your stack has no Node.js runtime available
• you require features like RSS feeds or decision backlogs that are not yet implemented

Facets

cli-tool · maturity active

documentation static-site-generator cli markdown documentation developer-tools cli cross-platform adr docs-as-code knowledge-base architecture-decision-records static-site architecture nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="thomvaill/log4brains")