Getting Started - Install and Launch lazyaz

Browse Azure Blob Storage, Service Bus, and Key Vault from your terminal. Navigate storage accounts, peek dead-letter queues, yank secrets — all without leaving the keyboard. Runs anywhere az login works.

Prerequisites

• Azure CLI (az) — install guide
• An active Azure subscription with resources to browse

No Go toolchain needed for the install script — it downloads a prebuilt binary.

Installation

macOS / Linux

curl -sSfL https://raw.githubusercontent.com/karlssonsimon/lazyaz/master/install.sh | sh

Installs to $HOME/.local/bin by default (or /usr/local/bin if writable).

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/karlssonsimon/lazyaz/master/install.ps1 | iex

Go

Requires Go 1.25+.

go install github.com/karlssonsimon/lazyaz/cmd/lazyaz@latest

Build from source

git clone https://github.com/karlssonsimon/lazyaz.git
cd lazyaz
go build -o lazyaz ./cmd/lazyaz

Prebuilt binaries for every release are also on the GitHub releases page.

Log in to Azure

Make sure you’re authenticated:

az login

If you work with multiple tenants, don’t worry — lazyaz supports switching tenants from within the app without re-opening a browser.

Launch

lazyaz

lazyaz --version (or -v) prints the build version. There are no other flags or subcommands — everything lives inside the TUI.

Your first 60 seconds

lazyaz ships with two keymaps: vim-style (default) and standard. Switch by setting keymap in ~/.config/lazyaz/config.json:

{ "keymap": "standard" }

Vim (default)

1. Pick a subscription — the subscription picker opens automatically. Type to fuzzy-filter, press Enter to select.

2. Browse resources — storage accounts, namespaces, or vaults appear in the left pane. Press Enter or l to drill in.

3. Navigate — j/k to move the cursor, Tab to switch panes, h to go back. It works like you’d expect.

4. Use the action menu — press a for context-aware actions: download blobs, requeue dead-letter messages, yank secrets.

5. Open the command palette — press Ctrl+P to search all commands: open new tabs, switch themes, switch tenants, browse the activity overlay, and more. (Switching subscriptions has its own top-level shortcut, S.)

Standard

1. Pick a subscription — the subscription picker opens automatically. Type to fuzzy-filter, press Enter to select.

2. Browse resources — storage accounts, namespaces, or vaults appear in the left pane. Press Enter or Right to drill in.

3. Navigate — arrow keys to move, Tab to switch panes, Left to go back.

4. Use the action menu — press a for context-aware actions: download blobs, requeue dead-letter messages, yank secrets.

5. Open the command palette — press Ctrl+P to search all commands: open new tabs, switch themes, switch tenants, browse the activity overlay, and more. (Switching subscriptions has its own top-level shortcut, S.)

Pre-configured tabs

Skip the subscription picker by configuring startup tabs in ~/.config/lazyaz/config.json:

{
  "tabs": [
    { "kind": "dashboard", "subscription": "your-subscription-id" },
    { "kind": "blob", "subscription": "your-subscription-id" },
    { "kind": "servicebus", "subscription": "your-subscription-id" },
    { "kind": "keyvault" }
  ]
}

lazyaz opens directly into these tabs on launch. If no startup tabs are configured, a Dashboard tab is opened by default. Unknown kind values are skipped with a warning on the first tab’s status bar. See Configuration for all options.

Next steps

• Navigation — learn the keyboard shortcuts and pane layout
• Blob Storage — browse containers, preview and download blobs
• Service Bus — peek queues and manage dead-letter messages
• Key Vault — browse secrets and copy values to clipboard
• Authentication — how Azure credentials work and what permissions you need