csv-insights

# csv-insights

Analyze CSV with sampled data for large files

## Installation

This is a CmdForge tool. Install via:

```bash
cmdforge install csv-insights
```

## Usage

```bash
# Analyze a CSV file with default question
cat data.csv | csv-insights

# Analyze with custom question
cat sales.csv | csv-insights --question "What are the top selling products?"

# Pipe from another command
curl https://example.com/data.csv | csv-insights --question "Identify any anomalies"

# Analyze local file
csv-insights < large_dataset.csv
```

## Arguments

| Flag | Default | Description |
|------|---------|-------------|
| `--question` | "What patterns and insights can you find?" | Question to ask about the CSV data |

## How It Works

This tool analyzes CSV files efficiently, even when they're large:

1. **Data Sampling & Statistics** - Loads the CSV and generates a representative sample with statistical summary to reduce token usage
2. **AI Analysis** - Sends the sampled data and statistics to Claude Haiku with your question for intelligent pattern recognition and insights

The sampling approach ensures fast analysis of large datasets while maintaining accuracy by preserving data distribution characteristics.

## Dependencies

None