@kszongic/wait-port-cli
v1.0.0
Published
Wait for a TCP port to become available — useful for CI/CD, Docker, and startup scripts
Maintainers
Readme
@kszongic/wait-port-cli
Wait for a TCP port to become available. Zero dependencies. Perfect for CI/CD pipelines, Docker compose scripts, and startup orchestration.
Install
npm install -g @kszongic/wait-port-cliUsage
# Wait for port 3000 on localhost
wait-port 3000
# Wait for a remote host
wait-port localhost:5432
# Custom timeout (60 seconds)
wait-port 127.0.0.1:6379 -t 60000
# Custom retry interval and quiet mode
wait-port db:3306 -i 1000 -qOptions
| Option | Description | Default |
|---|---|---|
| -t, --timeout <ms> | Timeout in milliseconds | 30000 |
| -i, --interval <ms> | Retry interval in milliseconds | 500 |
| -q, --quiet | Suppress output | false |
| -h, --help | Show help | |
Exit Codes
0— Port is available1— Timeout or error
Use Cases
Docker Compose — wait for database before starting app:
wait-port db:5432 && npm startCI/CD — wait for dev server:
npm run dev &
wait-port 3000 -t 15000 && npm testLicense
MIT © 2026 kszongic
