Net.Azure.ServiceBusConsole 0.7.0

azure-servicebus-console

A terminal UI browser for Azure Service Bus — explore namespaces, queues, topics, and messages directly from your terminal.

Install

Requires .NET 10 SDK and an active Azure CLI login.

dotnet tool install -g Net.Azure.ServiceBusConsole
az login
azsb

To update to the latest version:

dotnet tool update -g Net.Azure.ServiceBusConsole

Note: Subscription IDs are currently hardcoded. See Configuration.

Features

• Browse Service Bus namespaces across multiple Azure subscriptions
• Queues and topics with live message counts (active, DLQ, scheduled, transfer) — animated spinner while refreshing from cache
• Filter queues, topics, and subscriptions by typing in the filter box
• Scrollable tables — arrow keys or scrollbar to navigate long lists
• Peek, receive (PeekLock) or receive-and-delete a chosen number of messages, like the Azure portal's Service Bus Explorer
• Multi-select messages (Space, click the checkbox, A all, I invert) and act on all of them at once
• Locked messages: complete, abandon, dead-letter or requeue; locks renew automatically and are released when you leave
• Inspect message properties and body (auto pretty-printed if JSON) with a scrollable body panel
• Dead-letter queue browsing per queue and per subscription
• Requeue DLQ messages: republish locked dead-lettered messages to the origin queue/topic and complete them
• Delete individual queues, topics or subscriptions
• Mouse support: click buttons and rows, click a selected row to open it, scroll lists with the wheel

Screenshots

Data blurred; captured against the local Service Bus emulator.

Connection: pick a subscription and namespace

Queues: live counts, DLQ warnings, type to filter

Message detail: properties, dead-letter reason, pretty-printed JSON body

All subscriptions across every topic

Keyboard shortcuts

All screens

Connection screen

Queue list / Topic list / Subscription list

Queue browser / Subscription browser

Actions apply to the selected messages, or to the focused one when nothing is selected.

Message detail

Prerequisites

• .NET 10 SDK
• Azure CLI logged in:

az login

Authentication uses AzureCliCredential — no connection strings or API keys are stored.

Running from source

git clone --recurse-submodules https://github.com/zidad/azure-servicebus-console
cd azure-servicebus-console
az login
dotnet run

Logs are written to ./logs/session-<timestamp>.log on each run.

Configuration

Azure subscription IDs are hardcoded in Pages/ConnectionPage.razor in the SubscriptionOptions array. Update these to match your environment before running from source.

How message operations work

The browser follows the Service Bus Explorer in the Azure portal:

• Peek is read-only. F10 sends copies; the originals stay.
• Receive (PeekLock) locks the messages on a receiver that stays open. Locks are renewed in the background and abandoned when you leave the page or load something else, so messages come back right away instead of after lock expiry.
• Requeue sends copies to the origin queue (or the topic, for subscriptions: every subscription gets a copy) in order, then completes the locked originals.
• Receive (ReceiveAndDelete) removes messages immediately; requeue them before leaving or they are gone.

Bulk actions report partial failures; failed messages stay selected so you can retry.

Releasing

Every push to main checks the <Version> in ServiceBusConsole.csproj. If a tag for that version doesn't exist yet, the publish workflow will automatically create the tag, pack, and push to NuGet.org.

To release a new version, bump the version in ServiceBusConsole.csproj and merge to main:

<Version>0.2.0</Version>

Publishing uses NuGet trusted publishing — no API key secret is stored. The workflow exchanges a GitHub OIDC token for a short-lived nuget.org API key via NuGet/login.

This requires a trusted publishing policy on nuget.org (Account → Trusted Publishing) with:

Built with

• RazorConsole — Blazor Razor components rendered to the terminal via Spectre.Console
• Azure.Messaging.ServiceBus — Service Bus client
• Azure.ResourceManager.ServiceBus — namespace discovery via ARM