Home

two-go

A zero-dependency, fluent toolkit for testing HTTP services and APIs in Node. You build a request with a chainable API, attach the checks you care about, and await it. Checks throw on failure, so it works on its own and inside node:test, Jest, Vitest, and Mocha with no plugin.

npm install two-go --save-dev

import { go } from "two-go";

await go("https://api.example.com")
  .get("/users")
  .bearer(token)
  .expectStatus(200)
  .expectJson("data[0].id", 1);

In this wiki

• Getting Started - install, your first test, and the test runners
• Assertions - HTTP checks and the expect() matchers
• BDD - given / when / then, the JS layer and cucumber
• AI and MCP - test generation, failure explanation, bug review, MCP server
• Recipes - auth flows, polling, contract tests, CI, Docker
• FAQ - common questions

What is in the box

HTTP client and inline checks, a Jest-style expect(), soft assertions, polling (eventually / pollUntil), JSON snapshots, session chaining, a fake-data generator, async control-flow, a utility belt, JSON-schema validation and inference, OpenAPI/Postman importers, an optional AI layer, and an MCP server. All with zero runtime dependencies and TypeScript types included.

Links: npm | repo | examples