# Install lstr with Homebrew, Nix

Fast, minimalist directory tree viewer. Version 0.2.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:lstr
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install lstr
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#lstr
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ls/lstr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:lstr
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/lstr>
- **Version:** 0.2.1
- **Source summary:** Fast, minimalist directory tree viewer
- **Homepage:** <https://github.com/bgreenwell/lstr>
- **Repository:** <https://github.com/bgreenwell/lstr>
- **Upstream docs:** <https://github.com/bgreenwell/lstr#readme>
- **License:** MIT
- **Source archive:** <https://github.com/bgreenwell/lstr/archive/refs/tags/v0.2.1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- lstr (cli)
- lstr (alias)

## Build dependencies

- rust

## 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.2.1
- Local data: ok
- Upstream repository: https://github.com/bgreenwell/lstr
- Upstream latest detected: v0.2.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

lstr is a Rust directory tree viewer inspired by the classic `tree` command. Its README describes a fast, minimalist tool with both classic tree output and an optional interactive terminal UI.

### Project history

The GitHub repository was created in 2025 and the crate was published to crates.io the same month. The README presents the project as a small Rust CLI focused on essential tree-viewing features without broad configuration surface.

The project combines familiar `tree` behavior with modern terminal conveniences: LS_COLORS-aware coloring, optional icons, file sizes and permissions, git status markers, .gitignore-aware filtering, OSC 8 hyperlinks, and an interactive mode with keyboard navigation.

### Adoption history

lstr is newer than long-established tools such as tree, but it has already been packaged for Homebrew and Nix in the supplied package facts, and the README notes NetBSD package availability. The GitHub repository shows substantial early interest for a young filesystem CLI.

### How it is used

The basic CLI form is `lstr [OPTIONS] [PATH]`, defaulting to the current directory. Users can limit depth, show only directories, respect ignore files, sort by name, size, modification time, or extension, and pipe classic output to tools such as fzf, less, or bat.

The interactive mode is launched with `lstr interactive [OPTIONS] [PATH]`. The README documents keyboard controls for moving, expanding directories, opening files in `$EDITOR`, quitting, and printing a selected path to stdout for shell integration.

### Why package nerds care

lstr is representative of a modern wave of Rust replacements and companions for familiar Unix tools: not a wholesale reinvention of the shell, but a focused binary that adds git awareness, color conventions, icons, and TUI ergonomics while staying close to the `tree` mental model.

### Timeline

- 2025: GitHub repository created.
- 2025: crates.io metadata shows the lstr crate first published.
- 2025: README documents Homebrew, source, and NetBSD installation paths.

### Related projects

- Related tools include tree, eza, lsd, fzf, bat, Rust terminal UI libraries, LS_COLORS-aware file browsers, and git-aware filesystem viewers.

### Sources

- <https://api.github.com/repos/bgreenwell/lstr>
- <https://crates.io/crates/lstr>
- <https://github.com/bgreenwell/lstr>
- <https://github.com/bgreenwell/lstr#readme>
- source_facts.package-manager


## 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:** lstr
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - lstr: normalized package name match | nixpkgs package indexes: pkgs/by-name/ls/lstr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 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.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [parallel-disk-usage](https://www.automicvault.com/pkg/brew/parallel-disk-usage/) - Shares av.db curated category or tags: cli, filesystem, rust, system.
- [tre-command](https://www.automicvault.com/pkg/brew/tre-command/) - Shares av.db curated category or tags: cli, filesystem, system, tree.
- [acl](https://www.automicvault.com/pkg/brew/acl/) - Shares av.db curated category or tags: cli, filesystem, system.
- [afuse](https://www.automicvault.com/pkg/brew/afuse/) - Shares av.db curated category or tags: cli, filesystem, system.
- [attr](https://www.automicvault.com/pkg/brew/attr/) - Shares av.db curated category or tags: cli, filesystem, system.
- [avfs](https://www.automicvault.com/pkg/brew/avfs/) - Shares av.db curated category or tags: cli, filesystem, system.
- [bindfs](https://www.automicvault.com/pkg/brew/bindfs/) - Shares av.db curated category or tags: cli, filesystem, system.
- [convmv](https://www.automicvault.com/pkg/brew/convmv/) - Shares av.db curated category or tags: cli, filesystem, system.
- [diskus](https://www.automicvault.com/pkg/brew/diskus/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, fast, filesystem, rust, system.

## Combined YAML source

View the package source record on GitHub. [combined/lstr.yml](https://github.com/automic-vault/db/blob/main/combined/lstr.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
- external package-manager database matches
- cross-ecosystem install command graph
