---
title: "Local Recording (Desktop) | Speedscale Docs"
description: "Record locally on your desktop using proxymock CLI or MCP, then inspect and replay in proxymock web."
canonical: "https://docs.speedscale.com/proxymock/getting-started/quickstart/local/"
---

[Documentation index](https://docs.speedscale.com/proxymock/llms.txt) | [Markdown](https://docs.speedscale.com/proxymock/getting-started/quickstart/local/index.md) | [Canonical page](https://docs.speedscale.com/proxymock/getting-started/quickstart/local/)

# Local Recording (Desktop)

Record traffic on your machine and generate mocks/tests. Use the CLI or MCP to create a recording, then open proxymock web to explore, transform, and replay.

<a id="overview"></a>

## Overview

*   Record with CLI or MCP on your desktop
*   Inspect requests in proxymock web (Requests tab)
*   Replay locally or run in cluster (optional)

<a id="prerequisites"></a>

## Prerequisites

*   proxymock installed (CLI) and API key configured
*   Your service can run locally
*   Optional: start proxymock web to browse results

Start the web UI (optional)

```bash
proxymock web
# Open the printed http://127.0.0.1:XXXX URL
```

<a id="option-a--cli-workflow"></a>

## Option A — CLI workflow

Follow the end-to-end CLI quickstart for recording, inspecting, mocking, and replaying:

*   [proxymock CLI quickstart](https://docs.speedscale.com/proxymock/getting-started/quickstart/quickstart-cli/)

Key steps in brief:

1.  Install and init: `proxymock init`
2.  Record: `proxymock record -- <your run command>`
3.  Exercise your app: curl/tests hit proxymock IN port (default 4143)
4.  Inspect recordings in `./proxymock/recorded-*` and in proxymock web (Requests tab)
5.  Mock + Replay: `proxymock mock -- <run>` and `proxymock replay --test-against http://localhost:8080`

Screenshot placeholder: ./images/proxymock-web-requests-list.png

<a id="option-b-agent-workflow"></a>

## Option B: Agent workflow

Let your coding agent (Claude Code, Cursor, Codex and others) run the same steps with the proxymock MCP server and the Speedscale agent skills:

*   Agent tutorial: /proxymock/agent-tutorial/

Example prompts:

*   “Record traffic for my service using proxymock, then show me the recorded files.”
*   “Start a mock server with proxymock and replay the recorded traffic against my app.”

<a id="view-and-iterate-in-proxymock-web"></a>

## View and iterate in proxymock web

After recording, open proxymock web (if not already running):

1.  Start: `proxymock web` → open URL
2.  Requests tab: choose your `recorded-*` run from the Run selector
3.  Inspect a request/response pair and apply transforms as needed

Screenshot placeholders:

*   ./images/proxymock-web-run-selector.png
*   ./images/proxymock-web-request-detail.png

<a id="next-steps"></a>

## Next steps

*   Run in Cluster: /proxymock/getting-started/quickstart/in-cluster/
*   Live Tail (Web): /proxymock/getting-started/quickstart/live-tail/
*   How It Works: /proxymock/how-it-works/
*   Guides: /proxymock/guides/
