# Install literate-git with Homebrew

Render hierarchical git repositories into HTML. Version 0.5.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:literate-git
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install literate-git
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:literate-git
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/literate-git>
- **Version:** 0.5.3
- **Source summary:** Render hierarchical git repositories into HTML
- **Homepage:** <https://github.com/bennorth/literate-git>
- **Repository:** <https://github.com/bennorth/literate-git>
- **Upstream docs:** <https://github.com/bennorth/literate-git#readme>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://files.pythonhosted.org/packages/61/ef/443d7a7db6d72b4f905fe43ea34b3f7f6ca5b2edc0ad241290671ef6c454/literategit-0.5.3.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- git-dump-all-trees (cli)
- git-literate-render (cli)
- git-dump-all-trees (alias)
- git-literate-render (alias)

## Dependencies

- pygit2
- python@3.14

## Build dependencies

- pkgconf

## Uses from macOS

- libffi

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.5.3
- Local data: ok
- Upstream repository: https://github.com/bennorth/literate-git
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

literate-git is Ben North's proof-of-concept tool for rendering hierarchical Git histories into HTML. It treats a repository's commit graph as material for a literate-programming-style narrative, where merge commits can become expandable sections.

### Project history

The project pairs with `git-dendrify`, another Ben North tool that converts between linear and hierarchical Git histories. literate-git renders that hierarchy as a document containing parsed commit messages and source diffs, with top-level commits presented as sections and sub-commits available for expansion.

The README frames the work as an experiment in presenting software development the way articles or papers are structured: sections, subsections, and navigable explanation instead of one flat stream of commits.

### Adoption history

Adoption appears small and experimental. The project is distributed as the `literategit` Python package and as a Homebrew formula, and its README points to a Tamagotchi-style web-app demo rendered from a structured Git history.

### How it is used

The package installs `git literate-render` and `git dump-all-trees`. A typical workflow creates or dendrifies a structured branch, renders commit messages and diffs to an `index.html` file, and optionally exports source trees for result links.

### Why package nerds care

literate-git is package-nerd notable because it packages an unusual Git-history presentation idea rather than a mainstream VCS command. It turns commit topology into publishable documentation, which makes it adjacent to literate programming, tutorial authoring, and repository visualization.

### Timeline

- 2020-02-15: PyPI recorded 0.3.1 and 0.3.1rc1 releases of `literategit`.
- 2021-03-14: The README's demo branch and linked demo identify a Tamagotchi-style web-app render dated 2021-03-14.
- 2024-04-08: PyPI recorded version 0.4.6.
- 2026-04-03: PyPI recorded versions 0.5.2 and 0.5.3.

### Related projects

- Related projects include Git, git-dendrify, literate-programming systems, static HTML documentation tools, and repository-visualization experiments.

### Sources

- <https://github.com/bennorth/git-dendrify>
- <https://github.com/bennorth/literate-git>
- <https://pypi.org/project/literategit/>
- <https://redfrontdoor.org/blog/?p=1287>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** literate-git
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [adr-viewer](https://www.automicvault.com/pkg/brew/adr-viewer/) - Shares av.db curated category or tags: cli, developer-tools, documentation, html.
- [xmltoman](https://www.automicvault.com/pkg/brew/xmltoman/) - Shares av.db curated category or tags: cli, developer-tools, documentation, html.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [adr-tools](https://www.automicvault.com/pkg/brew/adr-tools/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [aicommit2](https://www.automicvault.com/pkg/brew/aicommit2/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [aicommits](https://www.automicvault.com/pkg/brew/aicommits/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [braid](https://www.automicvault.com/pkg/brew/braid/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control.
- [gitup](https://www.automicvault.com/pkg/brew/gitup/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, control, developer, developer-tools, git.
- [grokmirror](https://www.automicvault.com/pkg/brew/grokmirror/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, control, developer, developer-tools, git.
- [git-big-picture](https://www.automicvault.com/pkg/brew/git-big-picture/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, control, developer, developer-tools, git.

## Combined YAML source

View the package source record on GitHub. [combined/literate-git.yml](https://github.com/automic-vault/db/blob/main/combined/literate-git.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
