Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Mar 8, 2017
Mar 6, 2017
Mar 6, 2017
Jul 30, 2018
Mar 6, 2017
Mar 12, 2017


Terminal cli app that checks the availability of domains for different configurations of keywords.



You need to have Go installed.

# go get
# gomainr


The main purpose of this tool is to find available domains for different keywords. I.e.:

  • Keywords 1: foo bar
  • Keywords 2: alice bob
  • TLDs: com net

Will search for:


and return the available domain names.

Keywords 2 is optional, so you can just search for various domains among different TLDs.

You can save a session to a file and load it later again. This way you can view the results again without performing a new search. In addition this allows you to modify the keywords and repeat a search without typing the keywords all over again.

TLD Substitution

You can enable TLD substitution which will check if the end of your domain could be replaced by a TLD. I.e.:

fishnet -

Keyboard Shortcuts

Shortcut Action
CTRL+q Quit
CTRL+/ Search
UP, DOWN, TAB Navigate
CTRL+j Scroll result list down
CTRL+k Scroll result list up
CTRL+r Toggle TLD substitution
CTRL+s Save session
CTRL+l Load session

API Keys

By default gomainr will use DNS to query for available domains. This will be sufficient in most cases. Sometimes DNS servers can be configured incorrectly and this will result in incorrect results. To get more precise results gomainr supports both the and APIs. To do API based searches you need to obtain an API key from either service and add your credentials to the gomainr config file (make sure to disable the DNS source).

# $HOME/.gomainr/config

To be allowed to use the NameCheap API you need to fulfill certain conditions. It will also take up to 48 hours for NameCheap to activate your API access (if you ask nicely in the live chat they might do it right away though :). There are no restrictions for access to the GoDaddy API. Unless you already have a bunch of domains with NameCheap it's probably easiest to get a GoDaddy key.


To speed up consecutive searches and to keep things light on the APIs gomainr caches API request results for 24hrs. If you want to flush the cache for some reason you can delete the contents of this directory:

# $HOME/.gomainr/data


This project utilizes the following 3rd party packages


Terminal cli app that checks the availability of domains for different configurations of keywords.





No releases published


No packages published