# postmanlabs/newman

Newman is a command-line collection runner for Postman

Repository: https://github.com/postmanlabs/newman
Canonical: https://ross.abutalabs.com/products/newman
Homepage: https://www.postman.com
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: newman, postman-collection, json-report, postman, api-testing, api-test, jenkins, ci
Last push: 2026-08-05T06:42:35+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 35, longevity 100
- inputs: {"age_days": 4564, "days_push": 28, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7245, forks 1226 (observed 2026-08-28T04:09:57.788294+00:00)

## What it is
Newman is a command-line collection runner for Postman that executes Postman collections directly from the terminal. It is extensible with custom reporters and designed for integration with CI/CD systems like Jenkins.

## Use cases
- run postman collections from the command line
- run api tests in jenkins or ci pipeline
- generate  or junit reports from api test runs
- execute postman collection without the postman app
- automate api regression testing
- run postman collections in docker

## When to choose
- you already maintain Postman collections and want to run them in CI/CD
- you need headless, scriptable execution of API test suites
- you want pluggable reporters (CLI, JSON, JUnit, HTML) for test output

## When to avoid
- you are not using the Postman collection format
- you need a GUI for exploring and debugging APIs interactively
- you need load or performance testing at scale

## Facets
- artifact type: cli-tool
- maturity: stable
- function: testing, e2e-testing, http-client, cli, developer-tools
- domain: apis, testing, developer-tools
- platform: cli, cross-platform
- tags: postman, api-testing, collection-runner, ci-cd, jenkins, -report, junit-report, http-testing, command-line, automation, nodejs, docker

## Member repositories
- postmanlabs/newman (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:57.788294+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:39:44.346212+00:00, confidence not recorded.
  - readme: https://github.com/postmanlabs/newman (fetched 2026-08-28T04:09:57.788294+00:00, sha 72ff468d71d9)
  - homepage: https://www.postman.com (fetched 2026-08-29T08:34:49.424417+00:00, sha 25dc76603701)
  - site_page: https://www.postman.com/company/about-postman (fetched 2026-08-29T08:34:49.440402+00:00, sha ea39e0fa86cf)
  - site_page: https://learning.postman.com/docs/introduction/overview (fetched 2026-08-29T08:34:49.442332+00:00, sha f29ece5f2378)
  - site_page: https://www.postman.com/product/integrations (fetched 2026-08-29T08:34:49.433367+00:00, sha f5abd86d5583)
  - site_page: https://www.postman.com/pricing (fetched 2026-08-29T08:34:49.435615+00:00, sha 0769edc7b7c4)
  - site_page: https://learning.postman.com (fetched 2026-08-29T08:34:49.438274+00:00, sha bc59f5816183)
- Data as of 2026-08-30T08:39:29.467469+00:00.