tulz/README.md

A lightweight CLI tool for codebase analysis and aggregation - perfect for slow machines and text editor workflows

# Tuls CLI

A lightweight CLI tool for codebase analysis and aggregation. Born from the need for code awareness on slow machines where IDEs aren't practical.

## Features

- 📊 **Project Structure Analysis** - Visualize your project layout
- 📈 **Line Count Metrics** - See where complexity lives  
- 🔍 **DRY Analysis** - Find code duplication across files
- 🔗 **Import Validation** - Check for broken imports
- 📦 **Code Aggregation** - Combine multiple files into one

## Installation

```bash
npm install -g tuls-cli
Usage
bash
# Run all analyses
tuls all

# Individual commands
tuls structure    # Project structure
tuls lines        # Line count analysis
tuls dry          # Code duplication  
tuls imports      # Import validation
tuls aggregate    # Code aggregation

# Get help
tuls help
```
## Why Tuls CLI?

Built for developers who:

- Work on older/slower machines
- Prefer text editors over IDEs
- Need lightweight code analysis
- Want shareable code reports

## License
MIT