Terminal-native workflow
Token-efficient brand name verification from the terminal. Same safety output as web — scores, evidence, confidence, filing readiness. Pipe --json into your CI pipeline or feed it to agents.
Install
Install globally:
npm install -g brandomica
Or run directly:
npx brandomica check acme
Commands
| Command | Description |
|---|---|
| check <name> | Full brand check with score + safety + evidence |
| compare <names...> | Compare 2+ brand names side-by-side |
| batch <names...> | Check 2-50 names in one call, sorted by score |
| domains <name> | Domain availability + pricing (6 TLDs) |
| social <name> | GitHub, Twitter/X, TikTok, LinkedIn, Instagram |
| trademarks <name> | USPTO + EUIPO trademark search |
| safety <name> | Brand safety assessment (0-100 score, risk breakdown) |
| filing <name> | Filing readiness summary (verdict, risk, conflicts) |
| report <name> | Full brand safety report for due diligence |
| health | API component health status |
Most commands accept a --quick flag for faster checks with fewer upstream calls.
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 — use this in CI gates |
Exit code 2 lets you gate deploys on brand safety — the check succeeds but signals blockers for CI.
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"
Using CLI as an agent skill
- 1.
Zero context overhead
Unlike MCP, which loads tool schemas into the agent's context window, CLI exec returns only the JSON you asked for. No schema negotiation, no session state.
- 2.
SKILL.md discoverability
The CLI ships with a
SKILL.mdfile that describes all commands in a format agents can read. Agents like Claude Code auto-discover skills from this file — no manual configuration. - 3.
Composable
Pipe
--jsonoutput tojq, chain with other CLI tools, or feed into downstream scripts. Agents can build multi-step verification pipelines by composing CLI calls.
# Agent shell loop: check safety, then compare top candidates brandomica safety acme --json | jq '.blockers' brandomica compare acme nimbus zenflow --json | jq '.recommendation'
Environment variables
| Variable | Description |
|---|---|
| BRANDOMICA_API_URL | Override API base URL (default: https://www.brandomica.com) |
| NO_COLOR | Disable colors (respects no-color.org) |
Developer links