npm-cli-login
Log in to npm programmatically without STDIN/STDOUT for use in CI/CD pipelines and automated scripts.
What is npm-cli-login?
npm-cli-login is a Node.js command-line tool and library that allows programmatic login to npm registries. It solves the problem of authenticating npm in environments without interactive input, such as CI/CD pipelines, by updating the `.npmrc` file with authentication tokens using environment variables or command-line arguments.
DevOps engineers and developers setting up automated build pipelines, CI/CD systems, or scripts that require npm authentication without manual intervention.
It provides a reliable, scriptable way to handle npm authentication in headless environments, supporting both public and private registries with flexible credential input methods, unlike the standard interactive `npm login` command.
Overview
npm-cli-login is a utility that enables programmatic authentication with npm registries, including private registries, by modifying the .npmrc configuration file. It's designed for environments where interactive login isn't possible, such as continuous integration systems and automated deployment scripts.
Key Features
- CI/CD Integration — Authenticates npm without requiring STDIN or STDOUT, making it ideal for headless environments like Jenkins, Travis CI, or GitHub Actions.
- Private Registry Support — Logs into custom npm registries and handles scoped packages for private organizations.
- Flexible Configuration — Accepts credentials via environment variables or command-line arguments for different automation workflows.
- Programmatic API — Can be imported as a Node.js module for integration into custom scripts and tools.
- Custom .npmrc Management — Updates authentication tokens in the default or a specified
.npmrcfile, with support for quoted tokens containing special characters.
Philosophy
npm-cli-login focuses on simplicity and reliability for automated npm authentication, ensuring secure credential handling in non-interactive environments.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
