Back to blog

HookScope v1.2: Supercharged CLI, pause updates, CLI replay, and endpoint groups

HookScope just received one of the biggest updates since launch. Version 1.2 brings features that directly impact the daily workflow of anyone working with webhooks: CLI with new management commands, live update pause, CLI replay, and endpoint groups.

Let’s get to what matters!


CLI with superpowers

The hookscope CLI gained new commands that let you manage your endpoints, workflows, and plan directly from the terminal — without opening the browser.

Installation and update

# First installation
dotnet tool install -g HookScope.Cli

# Update to the latest version
dotnet tool update -g HookScope.Cli

Overview of new commands

When running hookscope without arguments, the CLI now displays a styled panel with all available commands:

 _   _                   _      ____
| | | |   ___     ___   | | __ / ___|    ___    ___    _ __     ___
| |_| |  / _ \   / _ \  | |/ / \___ \   / __|  / _ \  | '_ \   / _ \
|  _  | | (_) | | (_) | |   <   ___) | | (__  | (_) | | |_) | |  __/
|_| |_|  \___/   \___/  |_|\_\ |____/   \___|  \___/  | .__/   \___|
                                                       |_|

╭─Commands──────────────────────────────────────────────╮
│  login      Authenticate with your HookScope API key  │
│  logout     Remove saved credentials                  │
│  listen     Listen for webhooks and forward to a URL  │
│  endpoints  List all endpoints                        │
│  endpoint   View and manage a specific endpoint       │
│  workflows  List all workflows                        │
│  plan       View plan info and usage                  │
│  config     Show current configuration                │
╰───────────────────────────────────────────────────────╯

hookscope endpoints — overview in a table

List all your endpoints with status, forward mode, request count, and group:

hookscope endpoints
╭─Endpoints──────────────────────────────────────────────────────────────╮
│  Slug          Name            Status     Forward   Requests   Group  │
│  stripe-prod   Stripe Prod     ● Active   on        1,234      —     │
│  mp-sandbox    Mercado Pago    ● Active   proxy     342        pagto  │
│  github-ci     GitHub Actions  ● Paused   off       0          devs   │
╰────────────────────────────────────────────────────────────────────────╯

hookscope endpoint <slug> — interactive management

Access the interactive menu of an endpoint to toggle settings without leaving the terminal:

hookscope endpoint stripe-prod

The CLI displays the endpoint details and offers an action menu:

  • Toggle forward — enable/disable automatic forwarding
  • Change forward URL — change the destination URL
  • Toggle proxy mode — enable/disable proxy mode (returns upstream response)
  • Pause / Resume — pause or resume the endpoint
  • Toggle mock response — enable/disable custom mock response

All changes are applied immediately via API — no need to access the dashboard.

hookscope workflows — workflow listing

hookscope workflows

Displays your workflows with name, linked endpoint, status, execution count, and last execution.

hookscope plan — your plan and usage

View your current plan with intuitive usage bars:

hookscope plan
╭─Current Plan────╮
│  DEV             │
╰─────────────────╯

 Endpoints          2   5   ■■■■□□□□□□
 Workflows          1   2   ■■■■■□□□□□
 Daily Executions  45  1000 ■□□□□□□□□□

 Retention:           7 days
 Max Steps/Workflow:  3
 Member since:        2025-03-15

The bars change color based on usage: green (ok), yellow (warning), and red (near limit).


Live update pause

Until now, the endpoint detail screen received webhooks in real time without pause. In high-volume scenarios, this makes analysis difficult — the list changes before you can click on a request.

Now the dashboard has a pause button that freezes the request list on screen. While paused:

  • New webhooks continue to be captured and stored normally
  • The pending request counter appears on the button
  • The visible list remains static so you can inspect at your own pace
  • When resumed, accumulated requests are inserted into the list at once

The pause is persistent during navigation — if you open the detail of a request and go back, the pause state and accumulated queue are preserved. Nothing is lost.

When to use

  • Debugging high-volume integrations — pause, analyze the problematic request, and resume
  • Demos — freeze the screen while explaining the payload to the team
  • Load testing — pause before triggering requests and observe them arriving when you resume

CLI replay

Webhook replay already existed in the dashboard — clicking “Replay” re-sends the request to the configured forward URL. But what if you want to re-send the request to your localhost via CLI?

Now the request detail panel has a CLI Replay button that sends the webhook directly to the CLI session listening on that endpoint.

How it works

  1. In the terminal, start the listener:
hookscope listen my-endpoint --to http://localhost:3000/webhook
  1. In the dashboard, open any request from the history
  2. Click CLI Replay
  3. The request is sent via WebSocket to your CLI, which forwards it to localhost

The complete flow happens in milliseconds. It’s as if the webhook had just arrived — even if it was received hours or days ago.

Practical scenarios

  • You fixed a bug and want to re-test with the same payload that caused the error
  • You need to reproduce a specific scenario without asking the external service to re-send
  • You’re developing offline and want to test with real payloads captured previously

Endpoint groups

As the number of endpoints grows, finding what you need becomes increasingly difficult. Groups solve this.

Now you can organize endpoints into named groups to separate by project, team, environment, or any criteria that makes sense.

In practice

In the dashboard, grouped endpoints appear under collapsible headers. Ungrouped endpoints continue to be listed normally. In the CLI, the Group column appears in the listing:

hookscope endpoints
╭─Endpoints────────────────────────────────────────────────────────╮
│  Slug          Name           Status     Forward   Requests  Group  │
│  stripe-prod   Stripe Live    ● Active   on        1,234     pagto  │
│  mp-sandbox    Mercado Pago   ● Active   proxy     342       pagto  │
│  github-ci     CI Hooks       ● Active   off       89        devs   │
│  test-local    Tests          ● Active   off       12        —      │
╰──────────────────────────────────────────────────────────────────╯

Organization examples

GroupEndpoints
paymentsStripe, Mercado Pago, PagSeguro
ci-cdGitHub Actions, GitLab CI
communicationTwilio, SendGrid
devTest and sandbox endpoints

All together

These features were designed to complement each other. A typical flow can now be:

# See your endpoints organized by group
hookscope endpoints

# Start listening on the payments endpoint
hookscope listen stripe-prod --to http://localhost:5000/api/billing/webhook

# In the dashboard: pause live updates, analyze a problematic webhook,
# click CLI Replay to re-send directly to your localhost

# Manage the endpoint without leaving the terminal
hookscope endpoint stripe-prod

# Check your plan and limits
hookscope plan

Update now

# CLI
dotnet tool update -g HookScope.Cli

# Dashboard — no action needed, already updated

The new dashboard features (pause, CLI replay, and groups) are available for all plans, including Free. The new CLI commands also work on all plans.

Create your free account at hookscope.app and start capturing webhooks in minutes.