explaingit

rasaboun/dispo

Analysis updated 2026-05-18

15TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

dispo is a command-line tool that checks whether a domain name is available to register, using free RDAP and WHOIS lookups instead of a paid API.

Mindmap

mindmap
  root((dispo))
    What it does
      Checks domain availability
      No paid API needed
    Tech stack
      TypeScript
      Bun
      RDAP
      WHOIS
    Use cases
      Naming projects
      Bulk checks
      Agent skill
    Audience
      Developers
    Output
      Table
      JSON

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check whether one or many domain names are available before registering a project name.

USE CASE 2

Bulk-check a list of candidate domains across several extensions from a file.

USE CASE 3

Get JSON output from domain checks to feed into another script or automation.

USE CASE 4

Install dispo as a skill so an AI coding agent can check domain availability automatically.

What is it built with?

TypeScriptBunNode.jsRDAPWHOIS

How does it compare?

rasaboun/dispoaredotna/api-examplesceelog/openweread
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Can be run instantly with npx or bunx without any installation step.

No license is stated in the README.

In plain English

dispo is a command line tool that checks whether a domain name, like example.com, is available to register, without needing a paid API subscription or visiting a domain registrar's website manually. It is written in TypeScript and built to run with the Bun or Node.js JavaScript runtimes. The tool works by first querying RDAP, a modern registration data protocol, for the domain's top level extension. If RDAP is not available for that extension, it falls back to the older WHOIS protocol, opening a direct connection to WHOIS servers and pattern matching the response to figure out if a domain is registered or free. Results are classified as registered, available, or unknown when neither method gives a confident answer. You can run dispo instantly with npx or bunx without installing anything, install it globally as a command line program, build a standalone binary for Mac or Linux that does not require Bun at runtime, or run it directly from the source code. Once running, you can check one or many domains at a time, read a list of domains from a file or piped input, get output as a formatted table or as JSON, and control things like how many checks run at once, delays between requests, and which domain extensions to try for a base name. The tool paces its requests with a small delay by default to avoid overloading domain registries, and this delay can be adjusted or turned off. It also supports being installed as a skill for compatible AI coding agents, so an agent can automatically use dispo when a user asks it to check whether a domain name is free. The README notes that automated tests are included and run offline using mocked network calls. No license is stated in the README.

Copy-paste prompts

Prompt 1
Run dispo to check if example.com and example.io are available.
Prompt 2
Show me how to install dispo as a global CLI and check a list of domains from a file.
Prompt 3
Explain how dispo falls back from RDAP to WHOIS when a domain extension is not supported.
Prompt 4
Help me set up dispo as a skill so my coding agent checks domain availability automatically.

Frequently asked questions

What is dispo?

dispo is a command-line tool that checks whether a domain name is available to register, using free RDAP and WHOIS lookups instead of a paid API.

What language is dispo written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, Node.js.

What license does dispo use?

No license is stated in the README.

How hard is dispo to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is dispo for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.