✨ Features

• 🔎 DNS Lookup for all major record types (A, AAAA, CNAME, MX, TXT, NS and SRV)
• 🚀 Subdomain Enumeration with concurrency for speed
• 🛡 Zone Transfer (AXFR) checks to find misconfigurations
• ↩️ Reverse DNS lookups (IPv4 + IPv6)
• 🧩 Custom DNS Resolver (e.g., 8.8.8.8 or 8.8.8.8:53)
• 🎨 JSON or Colorized output
• 💻 Cross-Platform (Windows, macOS, Linux)

📦 Installation

Download prebuilt binaries (recommended)

Grab the latest ZIP/TAR for your OS/arch from the Releases page, extract it, and place the dnskit binary somewhere on your PATH so the dnskit command is available from a terminal.

Note dnskit is a command-line application. Double-clicking the executable in a file explorer (for example, on Windows) will only show a message telling you to use a terminal.

• Windows: download dnskit_*_windows_amd64.zip (or arm64), unzip, then run dnskit.exe from cmd.exe or PowerShell. To invoke dnskit from any folder, add the directory that contains dnskit.exe to your PATH.
• macOS: download dnskit_*_darwin_amd64.tar.gz (or arm64), extract, make it executable (chmod +x dnskit if needed) and move it to a directory on your PATH such as /usr/local/bin.
• Linux: download dnskit_*_linux_amd64.tar.gz (or arm64), extract, make it executable (chmod +x dnskit) and move it to a directory on your PATH.

Build from source

git clone https://github.com/nicokempe/dnskit.git
cd dnskit
go build -o dnskit .
# or install to $GOBIN
go install ./...

Official releases are built via GoReleaser and embed version/commit metadata. Local builds show dev unless you set -ldflags.

🚀 Usage

dnskit --help

Global Flags

• --json - Output results in JSON format
• --resolver <ip[:port]> - Use a custom DNS resolver

Subcommands

• lookup - Query a specific record type

  dnskit lookup <hostname> --type A|AAAA|MX|TXT|NS|CNAME|SRV

• enum - Enumerate subdomains with concurrency

  dnskit enum <domain> --wordlist subdomains.txt --concurrency 10

• transfer - Attempt DNS zone transfer (AXFR)

  dnskit transfer <domain> --nameserver <ns.host>

• reverse - Reverse DNS lookups (IPv4/IPv6)

  dnskit reverse <ip>

🧾 Versioning

Releases follow the format vYYYY.MM.VV:

• YYYY - year (e.g., 2025)
• MM - month (01–12)
• VV - sequential release number within the month (resets each month)

Examples:

• v2025.08.1 → first release in August 2025
• v2025.08.2 → second release in August 2025

📝 Release Workflow

1. Update Changelog

   Run changelogen to update CHANGELOG.md:

   npx changelogen@latest --output CHANGELOG.md

   Commit the updated CHANGELOG.md (e.g. as "docs(release): update changelog"".

2. Create a new release tag

   Use the provided script for your OS:

   • Windows (PowerShell)

     ./scripts/new-release.ps1 <version> (replace <version> with e.g. v2025.08.1)

   • Linux/macOS (Bash)

     ./scripts/new-release.sh <version> (replace <version> with e.g. v2025.08.1)

   These scripts:

   • Validate the version format
   • Commit any pending changes
   • Create a Git tag
   • Push tag ➜ triggers GitHub Actions GoReleaser

3. GitHub Actions builds & publishes

   Once the tag is pushed, the CI pipeline:

   • Builds binaries for Linux, macOS, Windows (amd64 + arm64)
   • Packages as .tar.gz, .zip, .deb, .rpm
   • Publishes assets to GitHub Releases
   • Updates Winget manifests

🧰 Development

• Requires Go 1.24+

• Quick build:

  go build -o dnskit .

• Cross-compile + package (local snapshot):

  goreleaser release --snapshot --skip=publish --clean

📝 Changelog

See CHANGELOG.md. Generated automatically from Conventional Commits via changelogen.

📜 License

This project is licensed under the MIT LICENSE.