Introduction
Jetic is a code-aware, agentic API behavior testing platform that understands your API from its source.
No manual scripts. No guessed constraints. No stale docs.
Copy the setup instructions into your agent (Claude Code, Cursor, Codex, and others). It will follow the recommended way to install Jetic, scan your API, and build the behavioral model.
What Jetic does
Traditional API testing tools force you to hand-write repetitive request scripts, hardcode authorization tokens, and guess what your handlers actually validate. Jetic starts from your code instead:
- Static source scanning — parses your project with
ts-morph(no server boot) to discover routes, path parameters, nested routers, and recognizable middleware. - Behavioral model — writes a versioned, strongly-typed graph of your API into
.jetic/model.json, including exact source provenance (file + line). - Stateful workflows — executes multi-step journeys from
.jetic/workflows/*.jsonwith dynamic capture and header injection. - Simulation & traces — runs your journeys against a live server and renders every step as an interactive graph in Jetic Studio.
No AI key required
Jetic does not need an OpenRouter/OpenAI account. The static scanner is keyless, and when you connect Jetic to your code editor over MCP your editor's own model drives the same tools.
The four primitives
Everything in Jetic revolves around four objects:
| Primitive | Answers | Artifact |
|---|---|---|
| Model | What exists? | .jetic/model.json |
| Workflow | What happens? | .jetic/workflows/*.json |
| Memory | What carries between steps? | .jetic/memory.json |
| Trace | What actually ran? | Jetic Studio /traces |
The 4-phase lifecycle
Jetic operates on a strict, predictable lifecycle so the model stays faithful to your code:
| Phase | Command / tool | Purpose |
|---|---|---|
| 1. Initialize | jetic init | Scaffold .jetic/ and an empty model |
| 2. Scan & model | jetic scan | Discover endpoints from source |
| 3. Verify | jetic_verify_model | Validate completeness and structure |
| 4. Simulate | jetic simulate workflow | Execute stateful journeys |
Documentation map
Getting Started
Install Jetic and run your first scan in under a minute.
Installation
Global install, from source, and package-vs-binary details.
CLI Reference
Every command, flag, and example.
Workflows
Author stateful journeys with capture, inject, conditions and retries.
Jetic Studio
The local web IDE: model, inspect, simulations, memory, traces, changes.
AI IDE (MCP)
Connect Jetic to Claude Code, Cursor, opencode and more.
Artifacts & Schemas
Reference for every .jetic/ file Jetic reads and writes.
Screenshots
A visual tour of Jetic Studio and the CLI.
Framework support
Automated AST scanning currently supports Node.js & Express (TypeScript) projects. For other stacks (FastAPI, Go, NestJS, …), model endpoints manually in Jetic Studio's Behavioral Model page, or let your editor's AI author the model through the MCP tools.