Overview
This guide is the proxymock entry point. Start with the install and quickstart flow, or jump straight to the language-specific first-success path that matches your app.
Getting started in 30 seconds
Let your coding agent (Claude Code, Cursor, Codex, Gemini CLI, Kiro, or any assistant that can read a URL and run commands) install proxymock for you. Paste this into the chat:
Install proxymock for me on this machine. First fetch the agent skill at
https://raw.githubusercontent.com/speedscale/skills/main/skills/install-speedscale/SKILL.md
and the references/ and scripts/ files it links to (same base URL), save them
under your skills directory, then follow the skill in local mode: proxymock and
its MCP server only, no Kubernetes operator.
The install-speedscale skill installs proxymock for your OS and walks you through proxymock init. Your recordings stay on your machine. It also connects the proxymock MCP server to your agent, so you can ask it to record, mock, and replay traffic. The agent stops for you at browser sign-in and asks before it changes anything outside your machine.
Prefer to install manually? Pick your OS:
- macOS
- Linux
- Other (Detailed)
Install with Homebrew:
brew install speedscale/tap/proxymock
Run the install script:
sh -c "$(curl -Lfs https://downloads.speedscale.com/proxymock/install-proxymock)"
For other operating systems and more detailed instructions, see the installation instructions.
Need another OS like Windows or are you having issues? See advanced installation.
Language-specific guides
- Java — Java demo app
- Kotlin — Kotlin demo app
- .NET — .NET demo app
- Node.js — Node.js demo app
- Go — Go demo app
- Python — Python demo app
- Ruby — Ruby demo app
- PHP — PHP demo app
- Rust — Rust demo app
- C++ — C++ demo app
What proxymock does for you
-
Observability into API and database payloads: Get an instant list of all calls going into and out of your app. proxymock records full-fidelity payloads without OpenTelemetry or other code changes.
-
Writes tests and mocks: Instantly create tests and mocks by recording inbound requests and outbound requests while your app runs.
-
Pair tester for your AI: Let your AI run its own realistic tests and isolation experiments so it can check its work and do more before interrupting you.
-
Replicates production environments: Instanly replicate a remote Kubernetes/ECS/VM environment to get real user requests, databases and other dependencies on your desktop.
Security profile
- Local by default: proxymock recordings stay on your machine unless you explicitly push or share them.
- Controlled cloud options: when you need centralized workflows, you can pair proxymock with Speedscale cloud or BYOC models based on your security boundary.
- PII controls in platform workflows: for in-cluster ingest, use Speedscale DLP to redact sensitive fields before data leaves your environment.
Why you'll love it
-
Human and AI readable markdown format - Get full visibility into your app's inbound and outbound requests in a format that works for LLMs and humans. Once you have a full fidelity recording of how your app behaves you can start to understand how it works.
-
Works with APIs, databases and even gRPC - Record and playback a wide variety of protocols include HTTP, Postgres, gRPC, AWS services, GCP services and more. Instead of standing up a test environment for Postgres, just record off the network and create a Postgres simulation with exact data.
-
Web UI - proxymock ❤️ s both vim and GUI users. Navigate your traffic in the local
proxymock webUI or view requests directly with an IDE. -
MCP inegration - proxymock makes its tools available via MCP. Check out our YouTube channel for prompt ideas that let your LLM use proxymock to analyze bugs.
proxymock runs entirely on your machine. The first time you run it you'll register a valid email to activate it (via proxymock init); it's free and your recorded traffic stays local. If you later want to deploy any of these mocks or tests in the cloud or CI/CD, use that same free account here.