rich-tree-cli 0.4.2

A command-line interface for visualizing directory trees with rich formatting and various options.

Rich Tree CLI

Rich Tree CLI provides a beautiful, colorful representation of your directory tree using the rich library. Generate stunning visual directory trees with custom icons, multiple export formats, and intelligent filtering - perfect for documentation, project exploration, and sharing repository structures.

Features

• Beautiful terminal output with colors and custom icons
• Multiple export formats: HTML, JSON, Markdown, SVG, TOML, XML, and plain text
• Smart filtering with built-in gitignore support and custom patterns
• Rich metadata including file sizes, line counts, and file types
• VS Code integration with clickable file links in HTML output
• Fast and lightweight with sensible defaults
• Highly configurable sorting, depth limits, and display options

Quick Start

Installation

Install the CLI globally so it's available from anywhere:

pip install rich-tree-cli

Or with uv:

uv pip install rich-tree-cli

Basic Usage

Generate a tree for the current directory:

rtree

Limit recursion depth:

rtree --depth 2

Export to multiple formats:

rtree --output-format html json markdown toml --output my_project

Show file metadata:

rtree --metadata all --depth 3

Command Options

rtree [DIRECTORY] [OPTIONS]

Core Options

Flag	Short	Description
--depth	-d	Maximum depth of recursion (0 = unlimited)
--output	-o	Output file path (extension determined by format)
--format	-f	Export format(s): text, html, json, md, svg, toml, xml
--metadata	-m	Metadata to display: size, lines, created, modified, all, none

Filtering Options

Flag	Short	Description
--exclude	-e	Exclude files/directories matching patterns
--gitignore	-g	Use .gitignore file (optionally specify path)
--sort	-s	Sort order: files first or dirs first

Display Options

Flag	Short	Description
--icons	-i	Icon style: emoji, glyphs, plain
--no-color		Disable colored output
--no-console		Suppress terminal output (export only)
--version	-v	Show version

Configuration File

You can set default options in ~/.config/rich_tree_cli/config.toml. CLI arguments always override config file settings.

[defaults]
depth = 3
metadata = ["size", "modified"]
icons = "emoji"
sort = "files"
no_color = false
no_console = false
format = ["text"]
exclude = ["node_modules", "__pycache__", ".git", "*.pyc"]
gitignore_path = "~.gitignore"

Available Options

Option	Type	Description
depth	int	Default max depth (0 = unlimited)
metadata	list	Default metadata fields: size, lines, created, modified, all
icons	string	Icon style: emoji, glyphs, plain
sort	string	Sort order: files, dirs
no_color	bool	Disable colors by default
no_console	bool	Suppress console output by default
format	list	Default output format(s)

Exclude patterns in [exclude].patterns are merged with any --exclude flags you provide.

Export Formats

HTML Export

Creates a beautiful web page with VS Code integration:

• Clickable file links that open in VS Code
• Custom CSS styling with terminal aesthetics
• Professional presentation ready for documentation

Markdown Export

Perfect for README files and documentation:

• Clean, readable format
• Integrates seamlessly with GitHub/GitLab
• Great for project overviews

JSON/TOML Export

Machine-readable formats for automation:

• Complete directory structure data
• File metadata included
• Easy integration with other tools
• TOML output uses [metadata] and [tree] tables mirroring the JSON structure

XML Export

Structured data for XML pipelines:

• Human and machine readable
• Works well with XSLT and other tooling

SVG Export

Vector graphics for presentations and documentation:

• Scalable visual representation
• Embeddable in web pages and documents
• High-quality output for any size

Examples

Documentation Generation

# Generate project overview for README
rtree --format md --output project-structure --depth 3

# Create interactive HTML documentation
rtree --format html --metadata all --output docs/structure

Development Workflows

# Quick project exploration
rtree --depth 2 --icons emoji

# Share repository structure with team
rtree --format html json --output project-overview --exclude "*.pyc" "__pycache__"

# Generate structure for AI assistance
rtree --format text --metadata size --depth 4

# Show size and modification dates
rtree --metadata size modified --depth 3

Advanced Filtering

# Exclude build artifacts and dependencies
rtree --exclude "node_modules" "dist" "build" "*.log"

# Use custom gitignore
rtree --gitignore .gitignore-custom --depth 5

# Show only directories
rtree --sort dirs

Why Rich Tree CLI?

• Developer-focused: Built by developers, for developers, with real workflow needs in mind
• Beautiful output: No more ugly ASCII trees - get professional, presentation-ready visualizations
• Flexible exports: One command, multiple formats - perfect for documentation, sharing, and automation
• Smart defaults: Works great out of the box with sensible gitignore patterns and file detection
• VS Code integration: Seamlessly integrates with your development environment

---

Built With

• Rich - Beautiful terminal output and formatting
• Jinja2 - Powerful HTML template generation
• pathspec - Gitignore pattern matching

---