README
¶
lazyaz
A keyboard-driven TUI for Azure — Blob Storage, Service Bus, and Key Vault.
lazyaz is to az what lazygit is to git: a fast terminal explorer that turns
common Azure browse-and-inspect tasks into a few keystrokes. No more clicking
through the Azure Portal to peek at a dead-letter queue or download a blob.
📖 Full documentation: karlssonsimon.github.io/lazyaz
Install
macOS / Linux:
curl -sSfL https://raw.githubusercontent.com/karlssonsimon/lazyaz/master/install.sh | sh
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/karlssonsimon/lazyaz/master/install.ps1 | iex
Or with Go:
go install github.com/karlssonsimon/lazyaz/cmd/lazyaz@latest
Requires Azure CLI logged in (az login). Go install additionally needs Go 1.25+.
Quick start
az login
lazyaz
Pick a subscription and start browsing. Press ? at any time to see keybindings
for the current view.
What it does
Blob Storage — Browse containers, navigate virtual folders, preview files with syntax highlighting, multi-select and download in bulk.
Service Bus — Peek active and dead-letter queues, requeue or move DLQ messages, inspect topics and subscriptions.
Key Vault — Browse vaults and secrets, view version history, yank secret values to clipboard.
All three run side by side in tabs with per-tab subscription selection.
Navigation
| Key | Action |
|---|---|
Tab / Shift+Tab |
Cycle pane focus |
Enter / l |
Open / drill in |
h / Left |
Go back |
/ |
Filter focused pane |
Ctrl+D / Ctrl+U |
Half-page scroll |
S |
Switch subscription |
a |
Action menu |
K |
Toggle inspect panel |
? |
Help |
Ctrl+P |
Command palette |
Ctrl+T |
New tab |
Configuration
Config lives in ~/.config/lazyaz/:
config.json— theme, download directory, startup tabs, keymapthemes/— Base16 color schemes (switch at runtime withT)keymaps/— JSON keybinding overrides
Thanks
Thanks to bosvik and svenclaesson for contributions and feedback.
License
MIT — see LICENSE. Third-party licenses in THIRD_PARTY_NOTICES.md.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
lazyaz
command
|
|
|
internal
|
|
|
appshell
Package appshell provides the UI scaffolding shared by the three Azure explorer apps (blobapp, sbapp, kvapp): subscription picker, theme/help overlays, loading spinner state, and the plumbing that ties them into Bubble Tea's update/view cycle.
|
Package appshell provides the UI scaffolding shared by the three Azure explorer apps (blobapp, sbapp, kvapp): subscription picker, theme/help overlays, loading spinner state, and the plumbing that ties them into Bubble Tea's update/view cycle. |
|
cache
Package cache provides a pluggable caching layer for hierarchical Azure resource trees.
|
Package cache provides a pluggable caching layer for hierarchical Azure resource trees. |
|
dashapp
Package dashapp is the dashboard tab — a read-only overview of Azure resources with a fixed set of widgets.
|
Package dashapp is the dashboard tab — a read-only overview of Azure resources with a fixed set of widgets. |
|
fuzzy
Package fuzzy provides fuzzy string matching powered by fzf's algorithm.
|
Package fuzzy provides fuzzy string matching powered by fzf's algorithm. |
|
jumplist
Package jumplist defines the small contract that lets the parent app maintain a vim-style ctrl+o / ctrl+i jump list across every child tab.
|
Package jumplist defines the small contract that lets the parent app maintain a vim-style ctrl+o / ctrl+i jump list across every child tab. |
|
keymap
Package keymap provides a unified, JSON-configurable keybinding system.
|
Package keymap provides a unified, JSON-configurable keybinding system. |