Good Feels CLI

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

Install

npm install -g @goodfeels/cli

Installed commands:

• goodfeels
• gf
• gfdg (legacy alias)

Quick Start

Authenticate once:

goodfeels auth login

Then run a few reads:

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:

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:

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

Common Commands

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