argus-demo-cli/README.md

Demo CLI tool for Argus financial control plane

# Argus Demo CLI

A demonstration CLI tool for the Argus financial control plane.

## Installation

```bash
npm install argus-demo-cli
```

## Configuration

The CLI requires two environment variables:

- `ARGUS_API_KEY` - Your Argus API key
- `ARGUS_BASE_URL` - The base URL for the Argus API

```bash
export ARGUS_API_KEY="your-api-key-here"
export ARGUS_BASE_URL="https://api.argus.example.com"
```

## Usage

```bash
# Show help
argus-demo-cli --help

# Evaluate a transaction
argus-demo-cli evaluate --amount 100 --currency USD --merchant "Example Store"
```

## Commands

### evaluate

Evaluate a transaction against policies.

Options:
- `-a, --amount <amount>` - Transaction amount
- `-c, --currency <currency>` - Currency code (default: USD)
- `-m, --merchant <merchant>` - Merchant name

### demo

Run a demo with 5 preset test transactions.

Options:
- `-i, --iterations <number>` - Number of iterations to run (default: 1)

Example:
```bash
# Run the demo once
argus-demo-cli demo

# Run the demo 3 times
argus-demo-cli demo -i 3
```

### seed-dashboard

Generate historical transaction data for dashboard analytics.

Options:
- `-d, --days <number>` - Number of days of history to generate (default: 30)
- `-t, --transactions-per-day <number>` - Average transactions per day (default: 25)

Example:
```bash
# Generate 30 days of history with 25 transactions per day
argus-demo-cli seed-dashboard

# Generate 7 days with 50 transactions per day
argus-demo-cli seed-dashboard --days 7 --transactions-per-day 50
```

This command generates realistic B2B transaction data including:
- Various merchant categories (SaaS, office supplies, travel, etc.)
- Natural time distribution (business hours, weekends)
- Mix of payment methods and currencies
- Realistic approval/rejection patterns

## License

MIT