Download Valkeyra for Mac

Coming soon. The Mac download is not available yet.

Requires macOS 26 or later and Touch ID. The Mac app includes the valkeyra command-line tool.

Signed and notarized

Valkeyra is signed with an Apple Developer ID and notarized by Apple. macOS checks this when you open the app.

After you unzip and move the app (step 2 below):

spctl -a -t exec -vv /Applications/Valkeyra.app        # "accepted", "source=Notarized Developer ID"
xcrun stapler validate /Applications/Valkeyra.app      # "The validate action worked!"
codesign -dv /Applications/Valkeyra.app 2>&1 | grep TeamIdentifier   # TeamIdentifier=Q759688B6H

If a check fails, do not open the app. Delete the file and tell us.

Install

  1. Open the zip. It gives Valkeyra.app.
  2. Move Valkeyra.app to the Applications folder (/Applications). If you open it from another folder (for example Downloads), Valkeyra says "Move Valkeyra.app to Applications" and does not start.
  3. Open it. Valkeyra says "Valkeyra is on" and runs in the menu bar (the key icon). If it says "Allow Valkeyra in Login Items", turn on Valkeyra in System Settings > General > Login Items, then open Valkeyra.app again. Valkeyra must run in the background to answer requests.
  4. The "Set up Valkeyra" window opens (only on a Mac that has no Valkeyra devices yet). Each Touch ID prompt says what it does: read it before you approve.
    • Set up this Mac. If your iCloud account has no Valkeyra devices, choose "Set Up as First Mac" (one Touch ID). The window shows the root fingerprint (6 root words). Write them down on paper. Keep them away from your computer. If your iCloud account already has a Valkeyra roster, choose "Join Your Roster…" and approve on one of its Macs.
    • Install the command-line tool. Choose "Install Command-Line Tool" (one Touch ID). It makes the link ~/.local/bin/valkeyra to the tool in the app and changes no other file. If Terminal says "command not found: valkeyra", add the line export PATH="$HOME/.local/bin:$PATH" to ~/.zprofile, then open a new Terminal window. Valkeyra does not change your shell files.
    • Optional: set up your coding agents. Choose "Agent Setup…". See Use Valkeyra with coding agents.

    To open this window again: Valkeyra menu > Set Up This Mac…

  5. Optional: get the iPhone app on the App Store, then choose "Join a Valkeyra Roster…" on the iPhone and "Add a Device…" in the Valkeyra menu on the Mac. Compare the 6-digit code and the 6 root words.

Update

Download the new version and replace Valkeyra.app in Applications. Your keys, devices, and audit log stay. Install the app and the command-line tool together (the tool is inside the app, so this happens when you replace the app).

Remove

/Applications/Valkeyra.app/Contents/MacOS/KeyStash --unregister
rm ~/.local/bin/valkeyra

Then move Valkeyra.app to the Trash. Your keys stay in iCloud Keychain. To delete keys, delete them in Valkeyra first (move to Trash, then purge).