tldx

Go Report Card codecov

tldx helps you brainstorm available domain names fast.

tldx openai -p get,use -s ly,hub -t com,io,ai --only-available
✔️ getopenaily.com is available
✔️ useopenaihub.io is available
  ...

📚 Table of Contents

• Features
• Usage
• Examples
  • Domain Availability
  • Regex Domain Selection
  • Presets
  • Permutations
  • Brace Expansion
  • Show Only Available Domains
  • Limit Results
  • Dry Run
  • Input from File or Stdin
  • Output Formats
• MCP
• Installation

⚡ Features

• 🔍 Smart keyword-based domain permutations (prefixes, suffixes, TLDs)
• 🎯 Regex pattern support for generating domain combinations (e.g., all 3-letter domains)
• 🚀 Fast and concurrent availability checks with RDAP
• 📤 Streams results as they're found
• 📦 Multiple output formats: text, json, json-stream, json-array, csv, grouped, grouped-tld
• 🔧 TLD presets to quickly select curated TLD sets
• 📏 Optional filtering by domain length
• 🤖 MCP server (tldx mcp) for AI agent integration

🛠️ Usage

Usage:
  tldx [keywords] [flags]
  tldx [command]

Available Commands:
  completion       Generate the autocompletion script for the specified shell
  help             Help about any command
  mcp              Start an MCP (Model Context Protocol) server over stdio
  show-tld-presets Show available TLD presets

Flags:
      --dry-run                 Print domains that would be checked without making network calls
  -f, --format string           Format of output (text, json, json-stream, json-array, csv, grouped, grouped-tld) (default "text")
  -h, --help                    help for tldx
  -i, --input string            File to read keywords from. Use "-" to read from stdin.
  -l, --limit int               Stop after finding this many available domains (0 = no limit)
  -m, --max-domain-length int   Maximum length of domain name (default 64)
      --no-color                Disable colored output
  -a, --only-available          Show only available domains
  -p, --prefixes strings        Prefixes to add (e.g. get,my,use)
  -r, --regex                   Enable regex pattern matching for domain keywords
      --show-stats              Show statistics at the end of execution
  -s, --suffixes strings        Suffixes to add (e.g. ify,ly)
      --tld-preset string       Use a tld preset (e.g. popular, tech)
  -t, --tlds strings            TLDs to check (e.g. com,io,ai)
  -v, --verbose                 Show verbose output
      --version                 version for tldx

Exit code 2 is returned when --only-available is set but no available domains are found.

🔗 Examples

Domain Availability

$ tldx google
❌ google.com is not available

$ tldx google youtube reddit
  ❌ reddit.com is not available
  ❌ google.com is not available
  ❌ youtube.com is not available

Regex Domain Selection

Use regex patterns with the --regex flag to generate domain combinations based on patterns:

# Check all 3-letter .com domains
$ tldx '[a-z]{3}' --regex --tlds com --only-available
  ✔️  aaa.com is available
  ✔️  aab.com is available
  ...

# Check all 2-letter domains with specific TLDs
$ tldx '[a-z]{2}' --regex --tlds io,ai --only-available
  ✔️  qa.io is available
  ✔️  zx.ai is available
  ...

# Combine patterns with prefixes
$ tldx '[a-z]{2}' --regex --prefixes my,get --tlds app --only-available
  ✔️  myaa.app is available
  ✔️  getab.app is available
  ...

Note: Patterns generating more than 500,000 combinations will be skipped.

Presets

$ tldx google --tld-preset popular
  ❌ google.com is not available
  ❌ google.io is not available
  ...

$ tldx google --tld-preset geo
  ❌ google.au is not available
  ❌ google.de is not available
  ❌ google.us is not available
  ...

You can see all available presets:

$ tldx show-tld-presets

TLD Presets:

all                     (use all available TLDs)

cheap                   pw fun icu top xyz blog info shop site click
                        space store online website

popular                 ai me app com dev net org

tech                    io ai gg app dev tech codes tools cloud games
                        software digital network security systems
                        data technology
...

Permutations

$ tldx google --prefixes get,my --suffixes ly,hub --tlds com,io,ai
  ✔️  mygooglely.com is available
  ✔️  getgooglely.ai is available
  ❌  mygoogle.ai is not available
  ...

Brace Expansion (macOS, Linux)

Brace expansion works out of the box in bash/zsh:

tldx {get,use}{tldx,domains} {star,fork}ongithub
  ✔️ gettldx.com is available
  ✔️ usetldx.com is available
  ❌ getdomains.com is not available
  ...

Show Only Available Domains

$ tldx google reddit facebook -p get,my -s ly,hub -t com,io,ai --only-available
  ✔️  getgooglely.ai is available
  ✔️  getreddithub.com is available
  ...

Limit Results

$ tldx stripe -p get,use -t com,io,ai --only-available --limit 3
  ✔️  getstripe.io is available
  ✔️  usestripe.ai is available
  ✔️  stripe.ai is available

Dry Run

$ tldx stripe -p get,use -t com,io --dry-run
Would check 6 domain(s):
  stripe.com
  stripe.io
  getstripe.com
  ...

Input from File or Stdin

$ tldx --input keywords.txt --tlds com,io --only-available
$ echo -e "stripe\natlas\nlinear" | tldx --input - --tlds com,io --only-available

Output Formats

By default output is human-readable (text). Change it with --format / -f.

Color is automatically disabled when stdout is not a terminal.

JSON Array

$ tldx openai -p use -s ly -t io --format json-array
[
  { "domain": "useopenaily.io", "available": true, "keyword": "openai", "prefix": "use", "suffix": "ly", "tld": "io" },
  { "domain": "openai.io", "available": false, "keyword": "openai", "tld": "io" },
  ...
]

With --show-stats the output is wrapped in an object:

$ tldx openai -p use -s ly -t io --format json-array --show-stats
{
  "results": [ ... ],
  "stats": { "total": 4, "available": 1, "not_available": 2, "errored": 1 }
}

Results include keyword, prefix, suffix, and tld metadata (empty fields are omitted).

JSON Stream

$ tldx openai -p use -s ly -t io --format json-stream
{"domain":"useopenaily.io","available":true,"keyword":"openai","prefix":"use","suffix":"ly","tld":"io"}
{"domain":"openai.io","available":false,"keyword":"openai","tld":"io"}

CSV

$ tldx openai -p use -s ly -t io --format csv
domain,available,keyword,prefix,suffix,tld,details,error
useopenaily.io,true,openai,use,ly,io,
openai.io,false,openai,,,io,

Grouped by Keyword

$ tldx openai google -p get,use -t com,io --format grouped

  google
  getgoogle.com
  getgoogle.io
  google.com
  google.io
  usegoogle.com
  usegoogle.io

  openai
  getopenai.com
  getopenai.io
  openai.com
  openai.io
  useopenai.com
  useopenai.io

Grouped by TLD

$ tldx openai google -p get,use -t com,io --format grouped-tld

  .com
  getgoogle.com
  getopenai.com
  google.com
  openai.com
  usegoogle.com
  useopenai.com

  .io
  getgoogle.io
  getopenai.io
  google.io
  openai.io
  usegoogle.io
  useopenai.io

MCP

tldx includes an MCP server for use with AI agents and IDEs.

tldx mcp

Example config (mcp.json / Claude Desktop / VS Code):

{
  "mcpServers": {
    "tldx": {
      "command": "tldx",
      "args": ["mcp"]
    }
  }
}

Available tools: check_domain, check_domains, generate_and_check, list_tld_presets.

📦 Installation

macOS (Homebrew)

brew install tldx

or

brew tap brandonyoungdev/tldx
brew install tldx

Windows (winget)

winget install --id=brandonyoungdev.tldx  -e

Arch Linux (AUR)

Two options are available for Arch Linux users:

• tldx - Build the package from source.
• tldx-bin - Build the package from releases.

Linux and Windows (Manual)

Visit the Releases page.

Download the archive for your OS and architecture:

• macOS / Linux: tldx_<version>_<os>_<arch>.tar.gz
• Windows: tldx_<version>_windows_<arch>.zip

tar -xzf tldx_<version>_<os>_<arch>.tar.gz
mv tldx /usr/local/bin/

Go (Install from Source)

go install github.com/brandonyoungdev/tldx@latest