akv-tui-rs

Crates.io	akv-tui-rs
lib.rs	akv-tui-rs
version	0.1.0
created_at	2025-11-20 20:39:11.988366+00
updated_at	2026-01-19 20:58:52.457074+00
description	A fast, intuitive terminal user interface (TUI) for managing Azure Key Vault secrets with fuzzy search, clipboard integration, and cross-platform support
homepage	https://github.com/jkoessle/akv-tui-rs
repository	https://github.com/jkoessle/akv-tui-rs
max_upload_size
id	1942549
size	1,146,324

Joni (jkoessle)

documentation

https://github.com/jkoessle/akv-tui-rs

README

A fast, intuitive terminal user interface for managing Azure Key Vault secrets with fuzzy search, clipboard integration, and cross-platform support.

Quick Start

Install

akv-tui-rs runs on Linux, macOS, and Windows. It can be installed from cargo, precompiled binaries, or source.

For example, to install from cargo:

cargo install akv-tui-rs --locked

All installation methods

Cargo

cargo install akv-tui-rs --locked

One-line Installer (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/jkoessle/akv-tui-rs/main/install.sh | sh

Manual Download

Download the pre-built binary for your platform from the Releases page.

Build from Source

Prerequisites (Linux)

On Linux, you might need to install XCB development libraries:

sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev

Steps

Clone the repository:

git clone https://github.com/jkoessle/akv-tui-rs.git
cd akv-tui-rs

Run directly:
```
cargo run
```
Or install globally:
```
cargo install --path .
```

Run

To run akv-tui-rs with default settings, use the following command:

akv

ⓘ Note:

You must be authenticated with Azure CLI (az login) before running the tool.

Features

⚡ Fast & Efficient: Built with Rust for maximum performance and minimal resource usage
🔍 Fuzzy Search: Quickly find secrets with intelligent fuzzy matching
📋 Clipboard Integration: Copy secret values with a single keypress
💾 Smart Caching: Reduces API calls and improves response times
🖥️ Cross-Platform: Works seamlessly on Linux, macOS, and Windows
🎯 Intuitive: Vim-style keybindings and clean interface for productivity

Secret Management

Vault Discovery: Automatically discovers accessible Key Vaults in your Azure subscription
List Secrets: Browse all secrets with fuzzy search filtering
View Values: Securely view secret values
Add Secrets: Create new secrets directly from the TUI
Edit Secrets: Update existing secret values
Delete Secrets: Soft-delete secrets when no longer needed

Usage

Authenticate: Run az login in your terminal if you haven't already
Start the Tool: Run akv
Select Vault: Use arrow keys or j/k to select a vault from the list and press Enter
Manage Secrets: Use the keybindings below to interact with secrets

Keybindings

Key	Action
`j` / `↓`	Move selection down
`k` / `↑`	Move selection up
`Enter`	Select vault / Copy secret value
`/`	Enter search mode
`a`	Add new secret
`e`	Edit selected secret
`d`	Delete selected secret
`r`	Refresh secrets
`v`	Back to vault selection
`q`	Quit application

Configuration

Debug Logging: Run with --debug to enable logging to azure_tui.log in the current directory:

akv --debug

Use Cases

DevOps Engineers: Quickly retrieve secrets during deployment and troubleshooting
Developers: Access API keys, connection strings, and credentials without leaving the terminal
Security Teams: Audit and manage secrets across multiple Azure Key Vaults

Troubleshooting

Common issues and solutions

Authentication Issues

Ensure you're logged in with Azure CLI: az login
Verify you have appropriate permissions on the Key Vault (Get, List permissions for secrets)
Check your Azure subscription is active: az account show

Build Issues on Linux

If you encounter linking errors related to XCB libraries:

sudo apt-get install libxcb-shape0-dev libxcb-xfixes0-dev

Clipboard Not Working

Linux: Ensure xclip or xsel is installed
macOS: Clipboard should work out of the box
Windows: Clipboard should work out of the box

Acknowledgements

akv-tui-rs is made possible by ratatui, crossterm, and the Azure SDK for Rust.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Related Projects

Azure CLI - Official Azure command-line interface
ratatui - The TUI framework powering this tool
azure-sdk-for-rust - Azure SDK for Rust

License

This project is licensed under the Apache License 2.0.

This project was built with the assistance of Antigravity and LLMs.

Commit count: 26