https://github.com/jongjinchoi/temper-domains
Search domain availability from your terminal. Open source, fast, private.
https://github.com/jongjinchoi/temper-domains
bun cli domain domains homebrew mcp rdap terminal tui whois
Last synced: 10 days ago
JSON representation
Search domain availability from your terminal. Open source, fast, private.
- Host: GitHub
- URL: https://github.com/jongjinchoi/temper-domains
- Owner: jongjinchoi
- License: apache-2.0
- Created: 2026-04-08T03:04:31.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-22T00:04:43.000Z (12 days ago)
- Last Synced: 2026-05-22T09:28:14.478Z (12 days ago)
- Topics: bun, cli, domain, domains, homebrew, mcp, rdap, terminal, tui, whois
- Language: TypeScript
- Homepage: https://temper-domains.vercel.app
- Size: 8.78 MB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Search domains, check availability, and open purchase pages — all from your terminal.
Works as a CLI, or as an MCP server so Codex, Claude, and Cursor can search domains for you.
Install ·
Usage ·
MCP ·
Themes
---
## Why
AI coding tools can't check if a domain is available. Claude suggests a name, you open a browser, search manually, come back — the flow breaks every time.
**temper fixes this.** One command. 30 TLDs. Under 2 seconds.
## Features
- **Private** — CLI and MCP queries run on your machine. No tracking, no telemetry. The hosted web demo uses a server-side API route for live checks.
- **Fast** — checks 30 TLDs by default with a 3s timeout. 59 with `--extended`.
- **MCP native** — Codex, Claude Code, Claude Desktop, and Cursor can search domains directly.
- **Keyboard-first** — vim-style navigation, single-key registrar selection.
- **Pipe-friendly** — `--format json` for scripting and automation.
- **Themeable** — 7 built-in themes (5 dark + 2 light).
- **Open source** — Apache 2.0. Zero telemetry.
## Install
```bash
# Homebrew (macOS/Linux) — no runtime needed
brew install jongjinchoi/temper-domains/temper
# Or run from source (requires Bun or Node.js >= 18)
bun install && bun run src/index.ts search
```
## Usage
```
$ temper --help
Usage: temper [options] [command]
Never leave your terminal to find a domain.
Commands:
search [options] Search domain availability across TLDs
suggest [options] [query] Generate name combinations and check availability
whois Show detailed WHOIS/RDAP info for a domain
init Set up temper (registrar + theme)
history Show search history
watch Add a domain to watchlist
list Show watchlist with current availability
show-presets Show available TLD presets
config Manage temper configuration
mcp Start MCP server over stdio
```
### Keyboard shortcuts
| Key | Action |
|-----|--------|
| `j`/`k` | Move up/down |
| `Enter` | Buy domain / select |
| `i` | WHOIS/RDAP detail |
| `/` | Filter results |
| `a` | Add to watchlist |
| `s` | Suggest combinations |
| `h` | Search history |
| `w` | Watchlist |
| `esc` | Back |
| `q` | Quit |
### Search
```bash
temper search myproject # 30 default TLDs
temper search myproject --extended # 59 TLDs
temper search myproject --tlds com,dev,io # specific TLDs
temper search myproject --tld-preset tech # preset: tech, popular, startup, cheap
temper search myproject -a # available only
temper search myproject -t 5 # 5s timeout (default: 3)
temper search myproject --format json # JSON output for piping
temper search localhoston writeholt tightship # multiple keywords
```
Navigate with `j`/`k`, press `Enter` to buy, `a` to add to watchlist, `/` to filter. Press `s` for suggestions, `h` for history, `w` for watchlist. `q` to quit.
#### TLD Presets
```bash
temper show-presets
popular com, net, org, io, co, app, dev, ai, me
tech io, ai, dev, app, gg, sh, tech, cloud, digital
startup com, io, co, ai, app, dev, xyz, so, gg
cheap xyz, fun, lol, top, site, online, store, shop, club
```
#### JSON output
```bash
temper search localhoston --format json | jq '.[] | select(.status == "available") | .domain'
```
### Whois
Look up detailed WHOIS/RDAP information for any domain. In search view, press `i` on any domain.
```bash
temper whois example.com # TUI view
temper whois example.com --format json # JSON output
```
Shows registrar, registration/expiry dates, nameservers, DNSSEC status, and EPP status codes. Uses RDAP (RFC 9083) when available, falls back to WHOIS.
### Suggest
Generate name combinations and check `.com` availability. Press `Enter` on any name to check all 30 TLDs.
```bash
temper suggest localhoston # default prefixes + suffixes
temper suggest localhoston -p super,mega -s io,lab # custom prefixes/suffixes
```
```
BASE
localhoston ✗ taken
PREFIX
getlocalhoston ✓ available
uselocalhoston ✓ available
trylocalhoston ✓ available
...
SUFFIX
localhostonapp ✓ available
localhostonlabs ✓ available
...
Summary: 13 available · 2 taken
```
Default prefixes: `get` `use` `try` `my` `go` `join`
Default suffixes: `app` `labs` `hq` `ly` `dev` `hub` `run` `kit`
### Watchlist & History
```bash
temper history # interactive search history (re-search, remove)
temper list # interactive watchlist (refresh, remove)
temper watch localhoston.com # add a domain to watchlist from CLI
```
In search view, press `a` to add a domain to your watchlist, `h` to view history, `w` to view watchlist.
### Setup
```bash
temper init # first-time setup (registrar + theme)
temper config theme seoul-night # change theme
temper config theme --list # list themes
```
MCP
temper runs as a local MCP server. Your AI assistant searches domains without you switching context.
> **Prerequisite:** Install temper first — `brew install jongjinchoi/temper-domains/temper`
### Codex
Codex stores MCP server configuration in `~/.codex/config.toml` and shares it between the Codex CLI and IDE extension. Add temper with:
```bash
codex mcp add temper -- temper mcp
```
In the Codex TUI, run `/mcp` to confirm the server is active.
You can also edit `~/.codex/config.toml` directly:
```toml
[mcp_servers.temper]
command = "temper"
args = ["mcp"]
```
### Claude Code
Pick one based on how you want temper available:
**All projects (recommended):**
```bash
claude mcp add --scope user --transport stdio temper -- temper mcp
```
**Current folder only:**
```bash
claude mcp add --transport stdio temper -- temper mcp
```
### Claude Desktop
Settings → Developer → Edit Config:
```json
{
"mcpServers": {
"temper": {
"command": "temper",
"args": ["mcp"]
}
}
}
```
Restart Claude Desktop after saving.
### Cursor
Settings → Tools & Integrations → New MCP Server (command type):
```json
{
"mcpServers": {
"temper": {
"command": "temper",
"args": ["mcp"]
}
}
}
```
### Windsurf
Edit `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"temper": {
"command": "temper",
"args": ["mcp"]
}
}
}
```
### VS Code (Cline)
Command Palette → `MCP: Add server` → stdio → `temper mcp`
---
**Tools:**
| Tool | Description |
|------|-------------|
| `search_domain` | Check 30 or 59 TLDs for a name |
| `suggest_domain` | 15 name combinations × 5 TLDs |
| `check_domain_availability` | Verify a list of domains (up to 100) |
| `whois_domain` | Detailed WHOIS/RDAP info (registrar, dates, nameservers) |
| `open_registrar` | Open purchase page in browser |
**Example: Brainstorm from scratch**
```
You: "I'm building a health management app. Suggest domain names."
Claude: [generates candidates: wellbi, vitalo, medra, healix, ...]
[calls search_domain for each]
[calls suggest_domain for top picks]
Top Pick: wellbi.app
- Short, pronounceable, .app TLD fits mobile apps
- getwellbi.com also available
⚠ Medra means "fear" in Spanish — avoid for global use
💡 Check @wellbi on social media before registering
```
**Example: Search with a name**
```
You: "Find domains for localhoston"
Claude: [calls search_domain]
localhoston.com is taken, but these are available:
- localhoston.dev, localhoston.app, localhoston.io
```
**Example: Check specific domains**
```
You: "Check getlocalhoston.com and trylocalhoston.com"
Claude: [calls check_domain_availability]
✓ getlocalhoston.com — available
✓ trylocalhoston.com — available
```
**Example: Buy a domain**
```
You: "Open Cloudflare for getlocalhoston.com"
Claude: [calls open_registrar]
Done. Cloudflare opened in your browser.
```
When temper runs as a local CLI or MCP server, queries run on your machine. The hosted website demo uses its own API route for live checks.
Themes
| | |
|---|---|
|  |  |
|  |  |
|  |  |
|  | |
| Theme | |
|-------|---|
| **Temper Forge** | 🔥 Flame orange on dark steel |
| **Seoul Night** | 🌃 Neon pink, Han River blue |
| **Catppuccin Mocha** | 🎨 Soft pastels |
| **Dracula** | 🧛 High contrast |
| **Default** | ⚫ Terminal native |
| **Catppuccin Latte** | ☀️ Pastel light |
| **Rosé Pine Dawn** | 🌅 Warm natural light |
## Contributing
```bash
git clone https://github.com/jongjinchoi/temper-domains.git
cd temper-domains
bun install
bun run src/index.ts search # run locally
bun test # run tests
```
Issues and pull requests are welcome.
## License
Apache 2.0 — see [LICENSE](./LICENSE)
---
temper — forged in the terminal. 🔥