extract-contacts

# extract-contacts

Extract contact info as structured CSV

## Installation

This is a CmdForge tool. Install it from the registry:

```bash
cmdforge install extract-contacts
```

## Usage

This tool accepts input via stdin (pipe) or file and outputs structured CSV data.

### Basic Usage

```bash
# From text input
echo "Contact me at [email protected] or call (555) 123-4567" | extract-contacts

# From a file
cat contacts.txt | extract-contacts

# Save output to file
extract-contacts < input.txt > contacts.csv
```

### Example Input

```bash
echo "Sales: Alice Smith ([email protected], 555-0100)
Support: Bob Jones <[email protected]> tel: 555-0200
Marketing: Carol White, email: [email protected]" | extract-contacts
```

### Example Output

```csv
name,email,phone
Alice Smith,[email protected],555-0100
Bob Jones,[email protected],555-0200
Carol White,[email protected],
```

## Arguments

This tool has no custom arguments.

## How It Works

The tool processes input through a 2-step pipeline:

1. **AI Extraction** (`step_1`): Uses the `opencode-pickle` provider to analyze the input text and extract contact information (names, emails, phone numbers) as structured JSON
2. **CSV Conversion** (`step_2`): Converts the JSON data into properly formatted CSV output

The final output is clean CSV data that can be imported into spreadsheets, databases, or other tools.

## Dependencies

This tool has no external dependencies beyond CmdForge itself.