treex

List directory contents as a tree with file and directory 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 lists its contents as a tree along with file and directory metadata.

Shows human-readable file sizes
Shows recursive directory sizes
Shows line counts for text files
Identifies binary and unreadable files by type
Optionally shows modification timestamps
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] [-q] [-d] [-s] [directory]

List directory contents as a tree with file and directory 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
  -q, --quiet     don't show file metadata
  -d, --dirs      show directories only
  -s, --summary   show summary only

Screenshot

Metadata

Release files for treex-cli 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for treex-cli 0.1.8
File	Size	Uploaded
treex_cli-0.1.8.tar.gz	6.4 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for treex-cli 0.1.8
File	Interpreter	ABI	Platform	Reset
treex_cli-0.1.8-py3-none-any.whl 6.5 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 12.9 kB

Release files / treex_cli-0.1.8.tar.gz

Download URL	treex_cli-0.1.8.tar.gz
Size	6.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`42c618f9b98e438c0d99c1e92a8c414d185364187120659678096e97004c3fc8`
BLAKE2b-256 checksum How to use checksums	`de1232cd3aa37eb0dcb3f6a7be385da3579aca7205f8d7cb39968d70bbda9f16`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / treex_cli-0.1.8-py3-none-any.whl

Download URL	treex_cli-0.1.8-py3-none-any.whl
Size	6.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`06c279c9c71c217b69ea177ece9816d2c289f409b6ea3f4d06a6c73ec8edc20b`
BLAKE2b-256 checksum How to use checksums	`95c42e0d4a83d5fee9b082df6f4ba82d6a420cccf7165e64c4993e5c030e45b0`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`