tria 0.4.2

Turn repositories into AI-friendly summaries

tria

Turn Python repositories into AI-friendly format (.md / .json/ .xml)

tria scans a git repository, analyzes commits, branches, and contributors, extracts and chunks files intelligently, and produces concise Markdown, JSON or XML summaries that are ready for LLM consumption. Perfect for onboarding and documentation generation.

🚀 Features

• ✅ Basic CLI with essential flags
• ✅ Local repository scanning
• ✅ Create project structure tree
• ✅ Analyze commits, branches and contributors
• ✅ Exclude binary files and common ignore patterns, default gitignore file support & custom exclusions
• ✅ Python, Markdown, Dockerfile and License parsers
• ✅ Simple line-based chunking
• ✅ Multiple output formats
• ✅ PyPI package (git2mind)

📦 Installation

# Install from PyPI
pip install tria

# or install from source
git clone https://github.com/yegekucuk/tria.git
pip install -e tria

🎯 Usage

Basic Usage

# Generate summary of current directory (markdown by default)
tria .


# Generate XML summary of current directory
tria . -f xml

# Include git history
tria . --git-history

# Specify the name of output file (gitignore is used by default)
tria /path/to/repo -o summary.md

# If you want to ignore .gitignore and include all files, disable it:
tria /path/to/repo -o summary.md --no-gitignore

# Exclude specific patterns
tria ./my-repo --exclude "tests" --exclude "*.log" --format md --output summary.md

# Verbose output with custom chunk size
tria . --verbose --chunk-size 100 --format json

Command Line Options

Usage: tria PATH [OPTIONS]

Options:
  -f, --format [md|json|xml]    Output format (default: md)
  -o, --output PATH             Output file path (default: ./tria_output.[md|json|xml])
  --exclude PATTERN             Exclude path pattern (can be repeated)
  --no-gitignore                Do not use .gitignore to exclude files (gitignore is used by default)
  --git-history                 Include git history (commits, contributors). Disabled by default
  --git-commits INT             Number of recent commits to include (default: 20)
  --chunk-size INT              Lines per chunk (default: 50)
  --max-files INT               Max files to process (default: 1000)
  --dry-run                     Do everything except writing output
  -v, --verbose                 Verbose logging
  -h, --help                    Show help message

📋 Default Exclusions

The following patterns are excluded by default:

• *.pyc, __pycache__
• .git, .venv, venv
• node_modules, dist, build
• *.egg-info
• Binary files
• Files larger than 100KB

🤝 Use Cases

• Documentation Generation - Create automatic project overviews
• Onboarding - Help new team members understand codebases
• AI Context Preparation - Prepare repositories for LLM analysis
• Project Auditing - Quick overview of project structure and content

📝 License

• Author: Yunus Ege Küçük
• MIT License - see LICENSE file for details