Getting Started

Welcome! Axo Pass is a secrets manager for MacOS dev environments.

Axo Pass stores secrets in encrypted vaults on your local machine, and the encryption key is protected by the Secure Enclave (envelope encryption).

Axo Pass comes with an app and also a command-line utility, ap.

To interact with Axo Pass from the command line or from other tools (SSH, GPG), you will need to install the ap CLI and set up shell integration.

Install the `ap` CLI

Add an alias to your shell configuration (e.g. .zshrc or .bashrc):

alias ap="/Applications/Axo\ Pass.app/Contents/bin/ap"

Or symlink the binary to a directory in your PATH:

ln -s "/Applications/Axo Pass.app/Contents/bin/ap" /usr/local/bin/ap

In the app, navigate to Setup > CLI for the full path, as well as one-click installation of the shell integration.

For zsh autocomplete and ssh-agent support, also add the following to your ~/.zshrc:

source <(ap shellenv zsh)

Restart your terminal after making changes.