Installation

npm (recommended)

Best for frontend projects. Installs a platform-specific binary as a dev dependency:

npm install -D @ridakaddir/apitwin

Use it via npx or in package.json scripts:

npx apitwin --init

{
  "scripts": {
    "mock": "apitwin --config ./mocks --target https://api.example.com"
  }
}

---

Binary download

Download a pre-built binary from the latest release:

macOS Apple Silicon:

curl -L https://github.com/ridakaddir/apitwin/releases/latest/download/apitwin_darwin_arm64.tar.gz | tar xz
sudo mv apitwin /usr/local/bin/

macOS Intel:

curl -L https://github.com/ridakaddir/apitwin/releases/latest/download/apitwin_darwin_amd64.tar.gz | tar xz
sudo mv apitwin /usr/local/bin/

Linux x86-64:

curl -L https://github.com/ridakaddir/apitwin/releases/latest/download/apitwin_linux_amd64.tar.gz | tar xz
sudo mv apitwin /usr/local/bin/

---

Go install

Requires Go 1.25+:

go install github.com/ridakaddir/apitwin@latest

---

Build from source

git clone https://github.com/ridakaddir/apitwin.git
cd apitwin
task build          # requires Task (https://taskfile.dev)
# or
go build -o apitwin .

---

Verify installation

apitwin --version
apitwin --help

---

Next: Quick Start