Introduction

Quadrastack is the AI-first, Git-native CLI command-line tool for testing HTTP APIs. It combines functional testing, load testing, and mock servers in a single binary, using a declarative YAML syntax that is designed for both humans and AI.

Why Quadrastack?

Modern API development has moved to the terminal and the IDE, but testing tools are often stuck in proprietary GUIs. Quadrastack brings API testing back to your workflow.

YAML-Based & Git-Native

Your tests shouldn't be hidden in a database or a proprietary file format.

• Edit in any editor: Universal YAML format works with VS Code, Vim, or Zed.
• Zero Information Loss: What you see in the file is exactly what runs. No hidden metadata.
• Review in PRs: Diff your test changes alongside your code changes in GitHub or GitLab.

AI-First Architecture

We designed Quadrastack to be the perfect companion for AI coding assistants.

• Schema-Driven: Our rigorous Playbook Schema allows LLMs (Claude, ChatGPT, Copilot) to generate valid, complex test suites in seconds.
• Context-Aware: Paste the schema into your AI window, and it "knows" how to write Quadrastack tests without hallucinations.
• Automated Scenarios: "Generate a smoke test for my User API" is now a working command.

All-in-One Tooling

Stop stitching together curl, JMeter, and distinct mocking tools. Quadrastack is a single Go binary that does it all:

• Functional Testing: HTTP/1.1 & HTTP/2 support with a powerful assertion DSL.
• Mock Servers: Spin up lightweight mocks defined in the same YAML files.
• Load Testing: Switch from functional to load testing by adding a loadProfile.
• Workflows: Chain requests together (e.g., Login -> Get Token -> Fetch Data).

Powered by VS Code

We treat the editor as our first-class UI.

• Integrated Extension: Run requests directly from your YAML files.
• Intellisense: Autocomplete for request fields, variables, and assertions.
• No Context Switching: Debug your API tests in the same window where you write your backend code.
• Private & Offline: No login required. No cloud dependencies. Your data never leaves your machine.

Key Features

Compact Assertion DSL

Write powerful checks without writing code.

expect:
  status: 200
  responseTime: < 500ms
  body:
    $.user.email: matches "^\\w+@\\w+\\.\\w+$"
    $.items.length: "> 0"

Instant Mocking

Define a mock server in seconds for frontend development.

mockServer:
  payment-api:
    listen: ":8080"
mocks:
  process-payment:
    server: payment-api
    match: { method: POST, path: /pay }
    respond:
      - { status: 200, body: '{"success": true}' }

Next Steps