The Hoppscotch CLI is a free, open-source way to run API collections from a terminal. If you already use Hoppscotch on the web or desktop, hopp test lets you push those same requests into a CI pipeline without paying for anything. That’s a real strength, and this article won’t pretend otherwise.
But the Hoppscotch CLI is also narrow on purpose. It runs collections and reports results. It doesn’t design APIs, mock them, document them, or manage them as code. So a lot of teams reach a point where they want a single tool that does more than execute a JSON file, or they hit a friction point like the Node v22 requirement and start shopping around.
What the Hoppscotch CLI actually does
The Hoppscotch CLI ships as the npm package @hoppscotch/cli. You install it globally:
npm i -g @hoppscotch/cli
One thing to know up front: it needs Node.js v22 or newer. If you’re stuck on Node 20, you stay on CLI v0.26.0, which can complicate a shared CI image where other jobs pin an older Node.
The core command is hopp test. You point it at a collection file (or a cloud collection ID) and it runs every request in order:
hopp test ./collection.json -e ./environment.json -d 500
For cloud or self-hosted instances, you pass an ID plus credentials:
hopp test <collection-id> -e <environment-id> --token <access_token> --server <server-url>
It executes pre-request scripts and test scripts (pw.test() suites, pw.expect() cases), validates responses, and exits non-zero if any assertion fails. It also supports --reporter-junit <path> for JUnit XML, plus --iteration-count and --iteration-data <csv> for data-driven runs. That’s a genuinely capable free runner.
Why teams look for a hopp test alternative
The reasons people search for a Hoppscotch CLI replacement are usually practical, not ideological:
- It’s a collection runner, nothing more. Design, mocking, and documentation live elsewhere. You end up stitching multiple tools together.
- You have to export JSON first. Specs and environments come in as exported collection/environment files (or cloud IDs). There’s no spec linting or design layer in the CLI itself.
- The Node v22 floor. Newer than what a lot of build images default to, which means extra version juggling.
- No spec-as-code workflow. You can’t manage endpoints, schemas, or branches from the CLI. The CLI is downstream of wherever you defined the API.
None of that makes Hoppscotch bad. It makes it a focused tool. If you want broader coverage, here are the alternatives worth your time.
1. Apidog CLI (best all-in-one alternative)
Apidog is an all-in-one API platform that covers design, debugging, mocking, documentation, and testing. The Apidog CLI brings the testing and resource-management side into the terminal and CI/CD, which is what makes it a strong alternative to a standalone collection runner.
With apidog run you execute test scenarios and collections from the command line. It supports data-driven testing through -d (CSV or JSON datasets), environments via -e, reporters in CLI, HTML, and JSON formats, and cloud test reports with --upload-report. Beyond running tests, the CLI can import OpenAPI and manage API resources, endpoints, schemas, environments, branches, and merge requests, as code. So your API definition and your tests live in the same system instead of being exported back and forth.
To be accurate about scope: Apidog validates specs on import, but it does not ship a standalone OpenAPI linter or a split/join/bundle command. If pure spec linting in CI is your goal, inso (below) is the better fit. Apidog’s pitch is integration, you design, mock, document, and test in one place, then drive the testing and resource layers from the CLI.
Pros:
- One platform for design, mock, docs, and test instead of a tool chain
- Data-driven runs with CSV/JSON datasets
- CLI, HTML, and JSON reporters, plus uploadable cloud reports
- Resource-as-code: manage endpoints, schemas, branches, and merge requests from the CLI
- Imports OpenAPI directly
Cons:
- No standalone spec-linter command (use inso or Redocly for Spectral-style linting)
- The full platform is more than you need if you only ever run one collection
If you’re weighing the two head to head, see Apidog CLI vs Hoppscotch CLI and the practical migrate Hoppscotch CLI to Apidog CLI walkthrough. The broader Apidog CLI complete guide covers install, auth, and the full command set. To try it, download Apidog.
2. Newman (the Postman runner)
Newman is Postman’s official command-line collection runner. If your team already lives in Postman, Newman is the path of least resistance: export the collection and environment, then run them in CI.
newman run collection.json -e env.json -r cli,json
It supports multiple reporters (CLI, JSON, JUnit, HTML via a plugin), data files for iteration, and a stable exit-code contract for pipelines.
Pros:
- Mature, widely documented, huge ecosystem
- First-class Postman compatibility
- Flexible reporters and data-driven iterations
Cons:
- Like Hoppscotch CLI, it’s a runner only, no design or docs layer
- Tied to the Postman collection format and its scripting model
- You still export JSON to use it
For a direct comparison with the Apidog approach, see Apidog CLI vs Newman.
3. inso (Insomnia CLI by Kong)
inso is the command-line companion to Kong’s open-source Insomnia client. It does something Hoppscotch CLI doesn’t: it lints OpenAPI specs. Linting runs on Spectral, the Stoplight OpenAPI linter, so if spec quality gates in CI matter to you, inso is a real contender.
inso run test "My Test Suite" --env "Staging"
inso lint spec "My API Design"
inso export spec "My API Design" --output output.yaml
inso reads from a .insomnia directory (created by Insomnia’s Git Sync) or the app data directory, and references suites and specs by name. You can install it with brew install inso or docker pull kong/inso:latest.
Pros:
- Real OpenAPI linting via Spectral
- Run tests and collections, export specs, all from the terminal
- Brew and Docker install paths
Cons:
- References resources by name, which can be brittle in scripts
- Insomnia 8 introduced a required cloud/login account in 2023 that drew backlash, and there were migration and data-loss incidents around that change. Worth knowing if you’re adopting the ecosystem fresh.
If you’re evaluating Insomnia more broadly, Apidog vs Insomnia and best Insomnia app alternatives are good next reads. There’s also a focused Apidog CLI vs inso (Insomnia CLI) comparison.
4. Step CI (open-source API testing in YAML)
Step CI is an open-source API quality tool that defines tests in declarative YAML rather than scripted JS. You describe the request and the expected response, and it checks them. It supports REST, GraphQL, and gRPC, which is broader protocol coverage than most collection runners.
npx stepci run workflow.yml
Pros:
- Declarative YAML, easy to read in version control
- Multi-protocol (REST, GraphQL, gRPC)
- No GUI dependency, config lives entirely in your repo
Cons:
- Smaller community and ecosystem
- No design, mock, or documentation layer
- You write tests by hand in YAML rather than recording them
Step CI is a good fit if you want git-native, human-readable tests and don’t need a UI at all.
5. Hurl (plain-text HTTP testing)
Hurl runs HTTP requests written in a simple plain-text format and asserts on the responses. It’s built on libcurl, runs fast, and produces clean output. There are no scripts and no JSON collections, just .hurl files you can diff in a pull request.
GET https://api.example.com/health
HTTP 200
[Asserts]
jsonpath "$.status" == "up"
Run it with:
hurl --test health.hurl
Pros:
- Extremely lightweight, single binary, fast
- Plain-text files that read like documentation
- Great for smoke tests and health checks in CI
Cons:
- Lower-level than a full test framework
- No design, mock, or docs features
- Less convenient for complex, chained, data-driven scenarios
Hurl shines for quick, readable contract and smoke checks. It’s not trying to be a platform.
Comparison table
| Tool | License | Core focus | Data-driven | Spec linting | Design/mock/docs | Report formats |
|---|---|---|---|---|---|---|
| Apidog CLI | Commercial (free tier) | Full platform + CLI testing | Yes (CSV/JSON) | No (validates on import) | Yes | CLI, HTML, JSON, cloud |
| Hoppscotch CLI | Open source | Collection runner | Yes (CSV iterations) | No | No | CLI, JUnit |
| Newman | Open source | Postman runner | Yes (data files) | No | No | CLI, JSON, JUnit, HTML |
| inso | Open source | Insomnia runner + linter | Limited | Yes (Spectral) | Partial (design docs) | CLI, JUnit |
| Step CI | Open source | YAML API tests | Yes | No | No | CLI, JUnit |
| Hurl | Open source | Plain-text HTTP tests | Via templating | No | No | CLI, JUnit, HTML |
How to choose
- You want one tool for design through testing: Apidog CLI. It removes the export-JSON-then-run dance and keeps your API resources and tests in the same system.
- Your team already uses Postman: Newman. Lowest switching cost.
- You need OpenAPI linting in CI: inso, because of Spectral.
- You want git-native, declarative tests: Step CI (YAML) or Hurl (plain text).
- You’re happy with a free OSS runner and just want off Node 22: any of the above, since Newman, Step CI, and Hurl don’t share that requirement.
If your main reason for leaving is the collection-runner ceiling rather than any single annoyance, the integrated route is the one to look at first. See Apidog CLI vs Postman CLI and Apidog CLI CI/CD pipeline for how the testing side fits into a real pipeline, and Apidog CLI test reports for the reporter options.
FAQ
Is the Hoppscotch CLI free? Yes. @hoppscotch/cli is open source and free to use. It runs collections, executes test scripts, and emits JUnit reports. The alternatives here aren’t about Hoppscotch being expensive, they’re about wanting more than a runner.
What’s the simplest alternative to Hoppscotch CLI if I don’t want Node v22? Hurl is a single binary with no Node dependency at all. inso installs via Homebrew or Docker. Step CI runs through npx but isn’t pinned to Node 22 the way the current Hoppscotch CLI is.
Can I move my existing Hoppscotch collections to another tool? Yes. Most tools accept exported collections or OpenAPI. For the integrated route, the migrate Hoppscotch CLI to Apidog CLI guide walks through importing and re-running your suites.
Does Apidog CLI lint OpenAPI specs like inso does? No. Apidog validates specs on import but doesn’t have a standalone linter command. If Spectral-style style-guide enforcement in CI is a hard requirement, pair Apidog with inso or use Apidog CLI vs Redocly CLI to compare the linting-focused option.
Which alternative is best for a CI pipeline? All of them return non-zero exit codes on failure, so all work in CI. The deciding factor is what else you need: pure runs favor Newman or Hurl; a single source of truth for design plus tests favors Apidog CLI; spec gates favor inso.
The Hoppscotch CLI does its one job well. If that one job is all you need, stick with it. If you’d rather collapse design, mocking, documentation, and testing into a single workflow instead of wiring runners together, an integrated platform is the move. Start with the Apidog CLI complete guide, then download Apidog and run your first scenario.



