Overview
Keploy turns traffic your application already serves into a regression suite. You start the app under `keploy record`, exercise it normally, and Keploy captures the API calls along with every dependency they touched — database queries, queue messages, outbound HTTP — writing them out as test cases plus the data mocks needed to replay them. Because it captures at the network layer with eBPF, there is no SDK to import and no code to change, and the approach is language-agnostic.
The replay side is what makes it more than a traffic recorder. Keploy virtualises the whole dependency surface rather than only HTTP endpoints: Postgres, MySQL and MongoDB, Kafka and RabbitMQ, external APIs. Tests run deterministically against those recordings, so a suite that would normally need a provisioned environment runs offline in CI. It also reports coverage from both angles — statement and branch coverage for developers, API schema and use-case coverage for QA — and can use existing recordings plus an OpenAPI/Swagger schema to generate additional cases around boundary values, missing or extra fields, wrong types and out-of-order sequences.
Keploy is written in Go, released under Apache 2.0, and listed in the CNCF landscape. It slots into the part of the delivery pipeline where integration tests usually rot: instead of hand-writing mocks that drift from production behaviour, the mocks come from the behaviour itself.
What it does
- Records API calls, database queries and streaming events as test cases with matching data mocks
- eBPF capture at the network layer — no SDK, no code changes, language-agnostic
- Infrastructure virtualisation beyond HTTP: Postgres, MySQL, MongoDB, Kafka, RabbitMQ, external APIs
- Deterministic replay, so integration suites run without re-provisioning infrastructure
- Combined coverage reporting: statement and branch for developers, API schema and use-case for QA
- Generates extra cases from recordings and OpenAPI/Swagger schemas — boundary values, missing fields, wrong types, retries and timeouts
Getting started
The whole loop is two commands around the command you already use to start your application. All commands below come from the project README.
Install the Keploy agent
The install script fetches the binary and sets it up for your platform.
curl --silent -O -L https://keploy.io/install.sh && source install.shRecord test cases
Start your app through Keploy and use it as normal — real API calls become tests and mocks.
keploy record -c "CMD_TO_RUN_APP"A concrete example
Whatever starts your service goes inside the quotes.
keploy record -c "python main.py"Replay them as a test run
Tests run offline against the recorded dependencies; `--delay` gives the app time to boot before traffic is replayed.
keploy test -c "CMD_TO_RUN_APP" --delay 10Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Reach for it when a service has real traffic but no integration tests, and writing them by hand has stalled
- Reach for it when test mocks keep drifting from what the dependencies actually return
- Reach for it to run integration and end-to-end suites in CI without provisioning databases or brokers
- Reach for it when you need API schema and use-case coverage numbers, not just line coverage
How Keploy compares
Keploy alongside other open-source ai sdlc automation tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| Multica | ★ 50.4k | Self-hostable workspace where coding agents are assigned issues like teammates: 26 agent CLIs, runtimes you own, a replayable execution log per run, and review gates before anything ships. |
| GPT-Pilot | ★ 33.7k | Autonomous AI developer that breaks down an app description into tasks, writes and runs code incrementally, and asks clarifying questions to produce a working production application. |
| oh-my-codex (OMX) | ★ 33.2k | A workflow layer for the OpenAI Codex CLI that adds agent teams, git-worktree isolation, hooks and HUDs behind a set of canonical plan, code-review and QA commands. |
| Vibe Kanban | ★ 28.1k | Vibe Kanban lets you plan tasks on a kanban board, run coding agents like Claude Code and Codex in isolated workspaces, then review their diffs and ship pull requests. |
| Beads | ★ 27.3k | A Dolt-backed dependency-graph issue tracker for coding agents: hash IDs avoid multi-agent collisions, `bd ready` surfaces unblocked work, and `bd remember` keeps durable project memory. |
| Archon | ★ 23.5k | A workflow engine for AI coding agents: describe plan, implement, validate, review and PR phases as YAML, and every run repeats them in its own git worktree. |
| Keploy | ★ 18.5k | Record real API traffic, replay it as tests and mocks — no SDK, no code changes |
| Superset | ★ 14.4k | An agentic IDE for macOS that runs 100+ CLI coding agents in parallel, each in its own git worktree, with a built-in terminal, diff viewer, in-app browser and completion notifications. |