cli-anything-wiremock
Python CLI harness for WireMock HTTP mock server administration
By hkuds · 402 installs
npx skills add hkuds/cli-anything --skill cli-anything-wiremock
Source repository · Upstream listing
Overview
cli anything wiremock is a command line interface that wraps the WireMock Admin REST API ( / admin/ ). It allows agents and developers to manage HTTP stub mappings, inspect served requests, control stateful scenarios, and record real backend traffic — all from the terminal or from agent tool calls.
WireMock is commonly used in integration testing environments to replace real HTTP backends with controllable mock responses.
Command Groups
stub — Manage HTTP stub mappings
Command Description
stub list List all registered stubs
stub get <id Get details of a specific stub by UUID
stub create <json Create a stub from a JSON string
stub quick M URL S Quickly create a stub: METHOD URL STATUS CODE
stub delete <id Delete a stub by UUID
stub reset Reset all stubs to the defaults on disk
stub save Persist in memory stubs to disk
stub import <file Import stubs from a JSON file
request — Inspect served requests
Command Description
request list List recent served requests
request find <pattern Find requests matching a JSON pattern
request count <pattern Count requests matching a JSON pattern
request unmatched List requests that matched no stub (404s)
request reset Clear the request journal
scenario — Stateful scenario management
Command Description
scenario list List all scenarios and current states
scenario set N S Set scenario NAME to STATE
scenario reset Reset all scenarios to their initial state
record — Record traffic from a real backend
Command Description
record start <url Start proxying + recording to TARGET URL
record stop Stop recording, return captured stubs
record status Check if currently recording
record snapshot Snapshot in memory requests as stubs
settings — Global server settings
Command Description
settings get Get current global WireMock settings
settings version Show WireMock server version
Top level commands
Command Description
status Check if WireMock is running
reset Full reset: stubs + requests + scenarios
shutdown Gracefully shut down the WireMock server
Key Examples
Agent Guidance
Always use json in agent contexts
Use json for all invocations in scripts or agent tool calls. JSON output varies by command type (these are distinct response types, not an envelope wrapping all responses):
Connection via environment
Set connection params via environment variables before calling any command:
Workflow pattern for test verification
1. Set up stubs before running the system under test:
2. Run the system under test.
3. Verify interactions:
4. Clean up:
Error handling
Non zero exit code on all errors. In json mode, errors return {"status": "error", "message": "..."} . Success returns the raw WireMock API response.