Overview of Stoobly agent (stoobly-agent)

Stoobly agent is a man-in-the-middle proxy that can intercept HTTP(s) requests to use for recording, mocking and replaying.

It is made of three main components:

  • A proxy server

  • A dashboard web interface

  • A command-line interface

Proxy Server

The proxy server is an extension of the open-source mitmproxy project.

Web Interface

The web UI can be used to create, view, update and delete requests and scenarios. It also has convenient buttons and drop-downs to change the agent mode to configure when you want to mock or record requests. Finally, it also provides an easy way to modify the proxy configuration for customizing rewrite and match rules.

Command-Line Interface

The CLI is ideal for using Stoobly as part of scripts and CI pipelines. To see what the CLI offers:

$ stoobly-agent                                                                                                                                                                                                                          10s
Usage: stoobly-agent [OPTIONS] COMMAND [ARGS]...

  --version   Show the version and exit.
  -h, --help  Show this message and exit.

  dev-tools  Access developer tools
  exec       Run shell command with proxy enabled
  feature    Manage features
  init       Initialize a new context
  mock       Mock request
  record     Record request

Proxy Commands:
  ca-cert    Manage CA certificate
  config     Manage proxy config
  intercept  Manage request intercept
  run        Run proxy and/or UI

Local Resource Commands:
  request    Manage requests
  scenario   Manage request scenarios

  Run 'stoobly-agent COMMAND --help' for more information on a command.

Source Code

The agent is open source and available on Github at

Last updated