tree Command

Display and validate your reference tree structure.

Basic Usage 

# Show tree structure
uv run para-files tree

# Validate for errors
uv run para-files tree --validate

Options

--validate

Check reference tree for errors:

uv run para-files tree --validate

# Reports:
# - Missing routes
# - Invalid paths
# - Syntax errors
# - Warnings

--issuers

List all known issuers (banks, companies):

uv run para-files tree --issuers

# Shows issuers organized by category

--rules

Show all routing rules:

uv run para-files tree --rules

# Shows glob patterns and special rules

-v, --verbose

Show detailed information:

uv run para-files tree --issuers -v
# Shows all issuers including less common ones

Examples

View Structure 

uv run para-files tree

Output:

PARA Structure:
  0_Inbox
  1_Projects
  2_Areas
  3_Resources
  4_Archives

Validate Configuration 

uv run para-files tree --validate

# Check for issues before moving lots of files

See All Issuers 

uv run para-files tree --issuers

# Output:
# Issuers by category:
#
# banques:
#   - UBS Switzerland
#   - Credit Suisse
#   - BCGE
#
# telecom:
#   - Swisscom
#   - Sunrise

Review All Rules 

uv run para-files tree --rules

# Shows pattern-based rules for classification

What tree Does

Shows your reference tree configuration:

  • PARA folder structure
  • All routes (categories)
  • All issuers (companies/banks/etc)
  • All routing rules
  • Configuration

Useful for:

  • Understanding your current setup
  • Validating before big operations
  • Finding issues
  • Learning what you’ve configured