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
- In the terminal, start the listener:
hookscope listen my-endpoint --to http://localhost:3000/webhook
- In the dashboard, open any request from the history
- Click CLI Replay
- 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
| Group | Endpoints |
|---|---|
payments | Stripe, Mercado Pago, PagSeguro |
ci-cd | GitHub Actions, GitLab CI |
communication | Twilio, SendGrid |
dev | Test 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.