treex

List directory contents in a tree format with file metadata.

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

About

treex is a command-line utility (similar to tree) that recursively scans a directory and prints its contents as a tree using Unicode box-drawing characters. File names include their human-readable size and, optionally, modification time. Text files also include their line count, while binary and unreadable files are marked with their type. When Git is installed, it respects .gitignore rules.

Requirements:

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

Status

Latest Version
Tests (CI)
Supported Python Versions

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] [-w N] [directory]

List directory contents in a tree format 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
  -w, --width N   starting column for file metadata (default: 50)

Screenshot