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: support@brandomica.com
• Security vulnerabilities: security@brandomica.com (private reports only)
• Security policy: see SECURITY.md

License

MIT