brandomica

CLI tool for Brandomica Lab — brand name verification from the terminal.

Check your brand name across domains, social handles, trademarks, web presence, app stores, and package registries. Get safety scores, filing readiness, and full reports — all from the command line.

Install

npm install -g brandomica

Or run directly:

npx brandomica check acme

Commands

check <name> — Full brand check

brandomica check acme           # Full check (score + safety + evidence)
brandomica check acme --quick   # Quick mode (fewer checks, faster)
brandomica check acme --json    # Raw JSON output

compare <names...> — Compare brands

brandomica compare acme nimbus zenflow

batch <names...> — Batch check

brandomica batch acme nimbus zenflow spark bolt     # Quick mode (default)
brandomica batch acme nimbus --mode full             # Full mode

domains <name> — Domain availability

brandomica domains acme

social <name> — Social handles

brandomica social acme

trademarks <name> — Trademark search

brandomica trademarks acme

safety <name> — Safety assessment

brandomica safety acme

filing <name> — Filing readiness

brandomica filing acme

report <name> — Full brand report

brandomica report acme
brandomica report acme --save report.json   # Save to file

health — API health

brandomica health

Global Flags

| Flag | Description | |------|-------------| | --json | Raw JSON output (pipeable) | | --plain | No colors or spinners (auto-detected when not a TTY) | | --api-url <url> | Override API base URL | | -V, --version | Show version | | -h, --help | Show help |

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success, no blockers | | 1 | Error (API failure, invalid input, network) | | 2 | Success but brand has safety blockers (for CI) |

Environment Variables

| Variable | Description | |----------|-------------| | BRANDOMICA_API_URL | Override API base URL (default: https://www.brandomica.com) | | NO_COLOR | Disable colors (respects no-color.org) |

CI Integration

# Check for blockers before deploying
brandomica check mybrand --json | jq '.safety.blockers | length'

# Exit code 2 = blockers found
brandomica safety mybrand || echo "Safety blockers detected"

Support

• GitHub Issues — bug reports, feature requests
• Email: [email protected]
• Security vulnerabilities: [email protected] (private reports only)
• Security policy: see SECURITY.md

License

MIT