project-tree-cli

A small, dependency-free Python CLI util that prints a recursive tree structure of a project – like a lightweight tree with sensible Python-flavoerd defaults.

Features

• Recursively prints tree of any given directory.
• Ignores __pycache__, .venv*, .idea*, .env, .env.*, .env-*, .git, *.pyc, *.pyo, *.pyd by default.
• -i / --ignore to add extra ignored files/folders (space- or comma-separated).
• -e / --excludefile [FILE] to load a .gitignore-like file with extra patterns.
• -s / --size to include human-readable file sizes.
• -o / --output [FILE] to write the output to custom path (project-tree.txt by default).

Installation

From PyPi (via pip or uv):

pip install project-tree-cli

uv tool install project-tree-cli

From GitHub:

pip install git+https://github.com/VanirSama/project-tree-cli.git

Usage

Example output

project-tree-cli -s -i tests -o

src/
└── project_tree_cli/
    ├── __init__.py  (86B)
    ├── __main__.py  (132B)
    ├── cli.py  (3.5KB)
    ├── core.py  (4.6KB)
    └── utils.py  (665B)

License

This project is licensed under the MIT License - see the LICENSE file for details.