Installation
Install jetic-cli globally, via npx, or build the monorepo from source.
Prerequisites
- Node.js
>= 20 - pnpm
>= 9(only needed when building from source)
Option A — Global NPM install
npm install -g jetic-cliOnce installed, npm registers the jetic binary on your PATH:
jetic --helpYou can also run it without installing:
npx jetic-cli --helpOption B — Build from source (monorepo)
git clone https://github.com/jeticlabs/Jetic.git
cd Jetic
pnpm install # Install workspace dependencies
pnpm build # Build all packages and apps
cd apps/cli
pnpm link --global # Expose the `jetic` binary globallyPackage name vs executable
The package is published as jetic-cli (npm install -g jetic-cli), but the command you type is jetic (jetic init, jetic scan, jetic dev, …).
Verify the install
jetic --help
jetic doctor # Diagnose Node version, config, adapters, and portsRequirements for the target project
Jetic works against an existing backend:
| Requirement | Needed for |
|---|---|
package.json | Framework and dependency detection |
tsconfig.json | Automatic jetic scan (Express + TypeScript only) |
| A running server | jetic simulate endpoint, jetic simulate workflow, live MCP testing |
Other frameworks and languages are supported by modeling endpoints manually in Jetic Studio, or by letting your editor's AI author the model through the MCP tools.
Monorepo layout
Jetic is a clean TypeScript pnpm monorepo:
jetic-cli — CLI executable & workflow runner
@jetic/dashboard — Jetic Studio web IDE
scanner — ts-morph static Express route analyzer
model — model schema types & Zod validators
simulator — data generation & endpoint simulation
memory — scoped runtime key-value store
core — config, filesystem sync, logger & errors
mcp-server — Model Context Protocol server
Package responsibilities
| Package | Name | Responsibility |
|---|---|---|
apps/cli | jetic-cli | Commander CLI: scanning, simulation, memory, config, and the embedded Studio server |
apps/dashboard | @jetic/dashboard | Jetic Studio local web app (model explorer, simulations, traces) |
packages/scanner | @jetic/scanner | Static Express route analysis via ExpressScanner / PathResolver |
packages/model | @jetic/model | Behavioral model schema types and validators |
packages/simulator | @jetic/simulator | DataGenerator, ResponseValidator, EndpointSimulator |
packages/memory | @jetic/memory | Persistence for .jetic/memory.json |
packages/core | @jetic/core | Config, .jetic initialization, and file helpers |
packages/mcp-server | @jetic/mcp-server | Stdio MCP server exposing the jetic_* tools |