NPM Package Name Checker & GitHub Username Validator – Instantly Find Available Names

NPM-GitNameCheck 🔍 – Professional NPM & GitHub Name Availability Checker

NPM-GitNameCheck is a fast and reliable CLI tool that instantly checks the availability of your desired NPM package names and GitHub usernames or repositories. Ensure consistent branding, prevent namespace conflicts, and generate detailed reports for teams.

🎯 Why Use NPM-GitNameCheck?

Stop wasting time manually checking names. This tool is perfect for developers, startups, and open-source maintainers who want to:

• Find available NPM package names quickly
• Maintain consistent branding across platforms
• Prevent username and repository squatting
• Generate audit-ready CSV, JSON, and TXT reports

✨ Features

• Check NPM registry, GitHub users, repositories, and web URLs
• Concurrency & retry logic with exponential backoff
• Rate-limit safe with jitter delays
• Output in JSON, TXT, CSV formats
• Supports GitHub tokens and proxies
• DNS-compliant name validation

📦 Installation

Global (recommended):

npm install -g npm-gitnamecheck

Local:

npm install npm-gitnamecheck

🚀 Quick Start

1. 1. Create wordlist.txt with names to check

myapp
cool-toolkit
brandx
superlib

1. 1. Run the CLI:

npx npm-gitnamecheck wordlist.txt

1. Review the results:
   • free-names.txt → available names
   • free-names.json → structured data
   • names-report.csv → detailed audit log

⚙️ Advanced Usage

npm-gitnamecheck wordlist.txt \
  --concurrency 30 \
  --retries 5 \
  --github-token ghp_xxx \
  --out ./results

Options

🔐 GitHub Token (Recommended)

Increase request limit from 60 → 5,000 per hour:

1. 1. Generate a personal token (no scopes required)
   2. Run the CLI with token:

npm-gitnamecheck list.txt --github-token ghp_yourtokenhere

📊 Sample Output

free-names.txt

myapp
superlib

free-names.json

[
  { "name": "myapp", "when": "2025-11-08T20:30:45.123Z" }
]

🔧 Programmatic Use (Node.js)

import { checkName } from 'npm-gitnamecheck';

const result = await checkName('myapp');
console.log(result.ok ? 'Available!' : 'Taken');

🎯 Ideal For

• NPM package launches
• Open-source project naming
• Brand protection & squatting detection
• CI/CD pipelines for name validation
• Startup MVP naming sessions

🤝 Contributing

We welcome contributions. Priority features include:

• Support for PyPI, Docker Hub, Deno
• Progress bar & resume functionality
• Domain & social media handle checks

Fork on GitHub →

👨‍💻 Author

Farbod Akvan – Full-Stack Developer & Open-Source Creator
Published by FireXCore

• GitHub: @FireXCore
• NPM: npmjs.com/~firexcore

📞 Support

• GitHub Issues: Submit issues
• Discussions: Ask questions
• Security: Private reports via GitHub Security