open-index/open-npm huggingface dataset:
npm package: @goodfeels/cli
Description: Good Feels gateway CLI for querying the hosted data gateway over HTTP.
Latest version: 0.1.4

# Good Feels CLI

Thin npm CLI for querying the hosted Good Feels data gateway over HTTP.

## Install

```bash
npm install -g @goodfeels/cli
```

Installed commands:
- `goodfeels`
- `gf`
- `gfdg` (legacy alias)

## Quick Start

Authenticate once:

```bash
goodfeels auth login
```

Then run a few reads:

```bash
goodfeels system capabilities
goodfeels metrics summary --range today
goodfeels ads summary --range last_30d --json
gf inventory list --json
```

## Auth

The CLI resolves credentials in this order:
1. `DATA_GATEWAY_TOKEN`
2. stored macOS Keychain token for the selected API URL
3. interactive prompt in a TTY

Helpful commands:

```bash
goodfeels auth login
goodfeels auth status
goodfeels auth logout
```

## Configuration

Supported environment variables:

- `DATA_GATEWAY_URL`
  Defaults to `https://goodfeels-data-gateway.fly.dev`
- `DATA_GATEWAY_TOKEN`
  Bearer token for authenticated requests
- `DATA_GATEWAY_TIMEOUT_MS`
  Request timeout in milliseconds. Defaults to `10000`
- `DATA_GATEWAY_GET_RETRY_COUNT`
  GET retries on timeout, network failure, `429`, or `5xx`. Defaults to `1`

One-off API override:

```bash
goodfeels --api-url https://goodfeels-data-gateway.fly.dev system health
```

## Common Commands

```bash
goodfeels --help
goodfeels --version

goodfeels metrics summary --range today
goodfeels orders breakdown --range last_7d --json
goodfeels discounts summary --range last_30d --json
goodfeels customers ltv --json
goodfeels revenue mrr --json
goodfeels email summary --range last_30d --json
goodfeels web traffic --range last_30d --json
goodfeels inventory list --json
goodfeels ads summary --range last_30d --json
```

## Hosted Gateway

- API docs: `https://goodfeels-data-gateway.fly.dev/docs`
- OpenAPI: `https://goodfeels-data-gateway.fly.dev/openapi.yaml`
- MCP endpoint: `https://goodfeels-data-gateway.fly.dev/mcp`
- Admin panel: `https://goodfeels-data-gateway.fly.dev/admin`

## Repo Docs

For gateway development and operations, see:
- `../../docs/OPERATIONS.md`
- `../../openapi/openapi.yaml`
- `../../DECISIONS.md`