# Install vsh with Homebrew, MacPorts, Nix HashiCorp Vault interactive shell. Version 1.0.0 via Homebrew; verified 2026-05-25. ## Install ```sh sudo av install brew:vsh ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install vsh ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install vsh ``` Evidence: MacPorts ports tree: security/vsh/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#vsh ``` Evidence: nixpkgs package indexes: pkgs/by-name/vs/vsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:vsh - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.0.0 - **Source summary:** HashiCorp Vault interactive shell - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-05-25T22:00:06Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - vsh (cli) - vsh (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.0.0 - Package-manager updated: 2026-05-25 - Local data: ok - Upstream repository: https://github.com/fishi0x01/vsh - Upstream latest detected: v1.0.0 (current) ## Project history and usage vsh is an interactive shell and CLI for HashiCorp Vault. Its project identity is to make Vault secret paths feel like directories and files, with familiar commands such as `ls`, `cd`, `cat`, `cp`, `mv`, `rm`, `grep`, and `replace`. ### Project history The project is maintained on GitHub by fishi0x01. Its README emphasizes transparency between KV version 1 and KV version 2 secret engines, recursive operations over Vault paths, non-interactive command execution for automation, and command documentation under `doc/commands`. The 1.0.0 release, published on GitHub in 2026, marks a maturation point: the release notes added concurrent recursive operations, a richer Bubble Tea-based interactive UI, safer recursive removal prompts, and static release binaries. ### How it is used vsh is used by operators and developers who work directly with Vault key-value secrets and want a shell-like navigation model rather than repeated raw `vault kv` commands. It uses Vault token helper behavior, supports common token environment variables, and documents permission needs such as List access for completion and path discovery. ### Why package nerds care vsh is niche but useful in the CLI ecosystem because it wraps a security service in traditional Unix shell verbs. That makes it attractive to users who think in paths, recursive copy/move/remove operations, and grep-like inspection of secret trees. ### Timeline - 2026: vsh 1.0.0 was released with concurrent recursive operations and a Bubble Tea-based interactive interface. ### Sources - Command docs directory: https://github.com/fishi0x01/vsh/tree/master/doc/commands - GitHub README: https://github.com/fishi0x01/vsh - GitHub releases: https://github.com/fishi0x01/vsh/releases ## Security Notes generalized runtime or code generation signal. - **Geiger risk:** yellow / medium - generalized runtime or code generation signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** vsh - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - vsh: normalized package name match | nixpkgs package indexes: pkgs/by-name/vs/vsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - vsh: normalized package name match | MacPorts ports tree: security/vsh/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [teller](https://www.automicvault.com/pkg/brew/teller/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security, vault. - [doppler](https://www.automicvault.com/pkg/brew/doppler/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security. - [fnox](https://www.automicvault.com/pkg/brew/fnox/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security. - [git-secret](https://www.automicvault.com/pkg/brew/git-secret/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security. - [ksops](https://www.automicvault.com/pkg/brew/ksops/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security. - [openbao](https://www.automicvault.com/pkg/brew/openbao/) - Shares av.db curated category or tags: cli, secrets-management, security, vault. - [ripsecrets](https://www.automicvault.com/pkg/brew/ripsecrets/) - Shares av.db curated category or tags: cli, secrets, secrets-management, security. - [secretspec](https://www.automicvault.com/pkg/brew/secretspec/) - Shares av.db curated category or tags: cli, secrets-management, security, vault. ## Combined YAML source View the package source record on GitHub. [combined/vsh.yml](https://github.com/automic-vault/db/blob/main/combined/vsh.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph