@speedscale/proxymock/README.md

A free desktop CLI that automatically creates mocks and tests from watching your app run.

# proxymock

A free command-line tool that automatically creates mocks and tests from watching your app run. proxymock is a backend service emulator that lets you run your app as if it were in a live environment.

## What is proxymock?

proxymock allows you to record, visualize, mock, and replay traffic on your local system. It captures your application's interactions with external services and creates realistic mocks that can be used for development and testing without hitting real APIs or databases.

### Key Features

- **Free for Local Development**: Complete functionality available at no cost
- **Record & Replay**: Capture real traffic from your application and replay it later
- **Smart Proxy**: Intercepts and mocks outbound requests without code changes
- **Realistic Mocks**: Generate mocks from actual production-like traffic
- **Multiple Protocols**: Support for HTTP, HTTPS, gRPC, and other TCP protocols
- **MCP Integration**: Model Context Protocol support for AI development tools

### Use Cases

- Develop locally without depending on live backend services
- Test applications when external services are unavailable or unreliable
- Bypass API rate limits during development
- Create consistent test environments
- Generate realistic test data from production traffic

## Installation

```bash
# Run the latest version
npx -y @speedscale/proxymock --help
```

The binary will be automatically downloaded and cached in `~/.speedscale/` on first run.

## Getting Started

For complete setup instructions and tutorials, visit the [proxymock documentation](https://docs.speedscale.com/proxymock/getting-started/quickstart-cli/).

## MCP (Model Context Protocol) Support

proxymock includes an MCP server for integration with AI development tools like Cursor and Claude Desktop. Add the following to your MCP config file and ask your AI coding tool what proxymock can do:

```bash
{
  "mcpServers": {
    "proxymock-simulator": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@speedscale/proxymock",
        "mcp"
      ]
    }
  }
}
```

## Support

Join our [Slack community](https://slack.speedscale.com/).  Seriously, come talk to us.