jeffbski/wait-on

Health v2 · maintenance only

Adoption not part of the score

1981 stars · 86 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

wait-on is a cross-platform CLI utility and Node.js API that waits for files, TCP ports, Unix sockets, and HTTP(S) resources to become available (or unavailable in reverse mode) before proceeding. It is commonly used to sequence commands in scripts and CI pipelines, such as waiting for a server to start before running tests.

Use cases

• wait for a dev server to start before running tests
• block a script until a file stops growing
• wait for a TCP port to be listening
• wait for an HTTP endpoint to return 2XX
• wait for a service to shut down before continuing
• sequence docker compose startup dependencies
• poll a health check endpoint in CI

When to choose

• you need to gate a command on files, ports, sockets, or HTTP endpoints becoming ready
• you want a simple cross-platform (Linux/macOS/Windows) wait utility with zero config
• you need both a CLI and a programmatic Node.js API
• you want reverse mode to wait for resources to disappear

When to avoid

• you need complex orchestration beyond simple resource readiness checks
• you want health checks with custom logic beyond HTTP 2XX status
• you are not in a Node.js-available environment
• you need service discovery or distributed coordination rather than local readiness polling

Facets

cli-tool · maturity stable

cli developer-tools workflow-automation http-client developer-tools cli cross-platform windows wait-for-resources port-waiting file-waiting tcp-sockets http-health-check npm-package reverse-mode service-readiness command-line devops automation nodejs linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jeffbski/wait-on")