Dochia - API Testing CLI | Bring Chaos with Love

4 min read Original article โ†—

Dochia Logo ochia

Bringing Chaos with Love

v2.1.1 โšก Agent-Ready

$ Dochia automatically generates and executes negative and boundary API testing. So you and your AI agents can focus on building, not breaking.

$ "It's like throwing a tantrum at your API, so your users don't have to."

$ Because nobody wants to debug why their "enterprise-grade" API can't handle a simple ๐Ÿคทโ€

How Dochia Works

1

Reads Your OpenAPI Specs

Understands your API structure automatically

2

Generates Smart Payloads

Creates thousands of context-aware test cases

3

Finds Hidden Issues

Discovers bugs you'd never think to test

4

Surfaces Issues. For You or Your Agent

Results are structured so both humans and AI agents can act on them immediately

Why Engineers Love Dochia

$

Instant Setup

Point it at your OpenAPI spec and go

*

Context-Aware Testing

Understands your API semantics

>

Agent-Actionable Reports

Clear fixes, not just problems. Formatted so AI agents can read, reason, and act on results directly.

#

120+ Built-in Playbooks

Negative, boundary, unexpected scenarios, and chaos testing. Ready to run, nothing to configure.

The Problem

โ€ข Engineers spend 40% of time on repetitive testing

โ€ข Manual testing misses critical edge cases and boundary conditions

โ€ข Traditional automation mostly tests the "happy path" scenarios

โ€ข Coding agents are capable, but miss structured playbooks, negative testing is improvised every time

The Solution

dochia automates the boring stuff

โ†’ Runs 120+ deterministic negative and boundary test playbooks against your API automatically

โ†’ Ensures your API works not just when everything goes right, but when everything goes wrong

โ†’ Finds the boundary conditions that would otherwise break production

โ†’ Exposes skills to your coding agents so they can run tests without leaving the loop

The Result

โœ“ 80% less time on manual negative testing

โœ“ 95% reduction in unexpected behavior at runtime

โœ“ More time for creative problem-solving

โœ“ Coding agents that ship validated APIs so human QA can focus on what actually matters.

โ€œ Let machines do machine work, humans do human work. โ€

$ Installation & Setup

[INFO] Get up and running in under 60 seconds

$ brew install dochia-dev/tap/dochia-cli

[INFO] macOS & Linux via Homebrew

$ curl -sSL get.dochia.dev | sh

[INFO] Direct binary installation

$ docker pull dochiadev/dochia-cli

[INFO] Containerized environment

[INFO] Expose skills to your coding agent

$ See It In Action

[DEBUG] Real-world API testing scenarios

human-mode

user@dev:~/api$ dochia test -c api.yml -s https://api.example.com

Starting dochia-cli-1.2.0, build time 2025-08-26T14:34:53Z UTC

๐Ÿงช Running tests...
   /public/events .............................. E 99, W 4, S 82 โœ”

โ˜‘ 185 tests completed in 2.354s

โœ” 82 passed, โš  4 warnings, โจฏ 99 errors

โ˜‘ Full Report: file:///Users/dochia-fan/openapi-project/dochia-report/index.html

agent-mode

user@dev:~/my-api$ dochia init-skills

โœ” Dochia skills initialized

# Your coding agent now knows how to run Dochia

# Sample agent triggers:

โ†’ "test my API"

โ†’ "check for 5XX errors"

โ†’ "run boundary testing"

โ†’ "validate my endpoints"

โ†’ "check input validation"

โ†’ "API hardening"

# Built for Developers. Ready for AI Agents.

/* Dochia turns aggressive testing into a graceful experience */

// Negative Testing

Automatically generate malformed requests, invalid payloads, and edge cases that break poorly designed APIs.

// Boundary Testing

Test the limits of your API with precision. Find exactly where your validation breaks down.

// Smart Fuzzing

Intelligent fuzzing that learns from your API schema and generates meaningful chaos.

// CLI First, Agent-Native

Built for the command line and coding agents. One command to expose Dochia skills to your agent.

// Agent-Readable Reports

Comprehensive reports with reproducible test cases. Structured for humans and parseable by AI agents.

// OpenAPI Support

Import your OpenAPI specs and let Dochia automatically generate comprehensive test suites.

// Dochia in Agentic Workflows

1. Agent writes new API endpoint

2. Agent runs: dochia test -c api.yml -s localhost:3000

3. Dochia produces dochia-summary-report.json + individual test .json files

4. Agent reads errors, fixes code, re-runs

5. Ship with confidence. Human never touched a test

As AI agents write more code, they need something to test it first. Dochia closes the agentic loop. It runs negative, boundary, and chaos tests so the agent can fix issues before they hit production.

Use dochia init-skills to expose Dochia skills to your coding agent.

user@dev:~$ cat pricing.json

[INFO] Choose your chaos level

#!/bin/bash

Free

$0/month

โœ“ 100+ Test Playbooks

โœ“ OpenAPI support

โœ“ Fuzzing

โœ“ HTML & JSON reports

โœ“ Tests Replay

#!/bin/bash

Premium (coming soon)

TBD

โœ“ More Test Playbooks

โœ“ Advanced fuzzing algorithms

โœ“ Non-OpenAPI support

โœ“ Execution Profiles

โœ“ Test Execution DSL