Skip to main content
@loftlyy/cli gives you terminal access to Loftlyy brand data for discovery, filtering, and export.

​
Install

npm i -g @loftlyy/cli
Run without installing: 
npx @loftlyy/cli list

​
Core commands

​
List brands

loftlyy list
loftlyy list --limit 10 --output json
Returns summary rows for all brands.

​
Get one brand

loftlyy get stripe
loftlyy get --slug apple --output json
Returns the full brand object for a slug.

​
Search brands

loftlyy search stripe
loftlyy search "#635BFF fintech"
loftlyy search --q "developer tools"
Search matches text fields and hex color tokens.

​
Filter brands

loftlyy filter --industry technology
loftlyy filter --tag design --color-family blue
loftlyy filter --typography-style sans-serif --q "payments"
Use facets first if you need the available filter values.

​
Find similar brands

loftlyy similar apple
loftlyy similar stripe --limit 10 --output json
Similarity is based on shared categories, tags, color families, industry, and typography style.

​
Get a palette

loftlyy palette stripe
loftlyy palette apple --output json
Returns a brand’s color names, hex values, and usage notes.

​
Inspect facets

loftlyy facets
loftlyy facets --output json
Returns available industries, tags, color families, and typography styles.

​
Global flags

| Flag | Purpose | | ------------------------ | -------------------------------- | ---------------------- | --------------------- | | --source <local | remote> | Force the data source. | | --base-url <url> | Override the remote API host. | | --output <table | json | ndjson> | Choose output format. | | --strict | Fail fast on invalid brand data. | | --no-color | Disable ANSI color output. |

​
Data source behavior

The CLI picks a default source automatically:
  • If data/brands/ exists in your current working directory, Loftlyy uses local.
  • Otherwise it uses remote.
Remote mode fetches from: 
https://loftlyy.com/api/cli
Override the host when you need a different deployment: 
loftlyy --source remote --base-url https://staging.loftlyy.com list

​
Output formats

  • table is best for terminal browsing
  • json is best for structured output
  • ndjson is useful for streaming into other tools
Example: 
loftlyy search stripe --output ndjson

​
Legacy namespace

The legacy namespace is still supported: 
loftlyy brands list
loftlyy b search apple