treex

List directory contents as a tree with file metadata

• Copyright (c) 2026 Corey Goldberg
• Development: GitHub
• Releases: PyPI
• License: MIT

About

treex is a command-line utility that recursively scans a directory and displays its contents as a tree along with file metadata.

• File names show human-readable sizes
• Text files show line counts
• Binary and unreadable files show their type
• Modification timestamps are optional
• Respects .gitignore rules when Git is installed

Status

Latest Version
Tests (CI)
Supported Python Versions

Requirements

• Python 3.10+
• Git 2.0+ (optional)
• UTF-8-compatible terminal

Installation

Install treex from PyPI using either pip or pipx:

• pip install treex-cli
• pipx install treex-cli

Usage

$ treex --help
usage: treex [-h] [-a] [-m] [-s] [directory]

List directory contents as a tree with file metadata.

positional arguments:
  directory       directory to scan (default: current directory)

options:
  -h, --help      show this help message and exit
  -a, --all       show all files (including those ignored by Git)
  -m, --modified  show file modification times
  -s, --summary   show summary only

Screenshot