Check npm package name availability from the command line. Pass one name or a few;
npmcheck checks them against the public npm registry.
Installation
Homebrew (macOS and Linux)
brew install arjunsajeev/tap/npmcheck
Go Install
go install github.com/arjunsajeev/npmcheck@latest
Download Binary
Download the latest binary from the releases page.
Usage
Check if one or more package names are available on npm:
npmcheck my-awesome-package another-package
Scoped package names work too:
npmcheck @my-scope/my-package
- ✅ available
- ❌ taken
⚠️ error
Show the installed version:
Development
Prerequisites
- Go 1.25 or later
- Optional:
justfor the shortcuts below
Building
Using just:
just
just build
just test
just ciOr directly with Go:
gofmt -w . go vet ./... go build -o npmcheck go test ./... go install
Testing GoReleaser
To test the GoReleaser configuration locally without publishing:
goreleaser release --snapshot --clean
Releasing
This project uses GoReleaser for automated releases.
To create a new release:
-
Tag the commit with a semantic version:
git tag -a v1.0.0 -m "Release v1.0.0" git push origin v1.0.0 -
GitHub Actions will automatically:
- Build binaries for multiple platforms (Linux, macOS, Windows)
- Create a GitHub release
- Update the Homebrew formula
License
MIT