mocks

name	mocks
description	Start or stop the WireMock API mock server for UI testing and E2E verification.
user-invocable	true
allowed-tools	Bash
argument-hint	[start|stop]

WireMock Mock Server

Manage the WireMock mock server that serves API responses for UI tests and E2E verification.

Requires Java (brew install openjdk if missing).

Start

./API-Mocks/scripts/start.sh 8282 &
sleep 3

Verify it's running:

curl -s http://localhost:8282/__admin/ > /dev/null && echo "WireMock running on port 8282" || echo "WireMock failed to start"

If Java is not installed, report the prerequisite and stop.

Stop

./API-Mocks/scripts/stop.sh 8282

Uses WireMock's graceful shutdown endpoint. Falls back to kill-by-port if the shutdown endpoint is unreachable:

kill $(lsof -ti:8282) 2>/dev/null

Details

• Port: 8282 (default)
• Mappings: Modules/Sources/APIMocks/Resources/mappings/
• Response files: Modules/Sources/APIMocks/Resources/__files/
• Start script: API-Mocks/scripts/start.sh
• WireMock: auto-downloaded on first run (version configured in start.sh)