Skip to content

1Password CLI

1Password (AgileBits Inc.) · Access 1Password vaults and secrets from the terminal, inject credentials into commands, and automate with scoped service accounts.

CaskSecurity & Privacy
Install command
brew install --cask 1password-cli
30-day installs
27,273
#13 in App
1-year installs
398.8K
Last 365 days
Latest version
2.42.0
Download size
15MB
zip
Release cadence
Every 2 weeks
1 release in 30 days

About

1Password CLI brings 1Password vaults and developer secrets into the terminal. The op command is intended for developers, administrators, and automation that need controlled access to credentials without hard-coding them in scripts.

Main capabilities

  • Find and manage vaults and items using command-line commands.
  • Read secrets through op:// references; load them into a child process with op run or substitute them into configuration templates with op inject.
  • Authenticate through the 1Password desktop app, including supported biometric authentication, or use a service account token scoped to selected vaults or Environments for headless automation.
  • Generate shell completions for Bash, Zsh, and Fish. Separate 1Password Shell Plugins integrate authentication with supported third-party developer tools.

Installation and first use

On macOS, install this Homebrew cask with brew install --cask 1password-cli, then check op --version. Homebrew links op into its binary directory and generates shell completions. For desktop authentication, install and sign in to the 1Password desktop app, enable Settings → Developer → Integrate with 1Password CLI, then try op vault list. With multiple accounts, op signin selects an account. Service accounts are the recommended alternative for shared builds and headless servers; configure only the access needed by your automation.

Systems, dependencies, and conflicts

The official macOS getting-started guide specifies macOS Big Sur 11 or later and Bash, Zsh, sh, or Fish. Official downloads support Apple Silicon and Intel Macs. Windows and Linux builds are available separately: Windows documentation uses PowerShell; Linux desktop integration requires 1Password for Linux, PolKit, and a running PolKit authentication agent. Desktop-app integration requires the corresponding installed 1Password app and an eligible signed-in account; it is distinct from service-account authentication. This catalog entry installs the macOS CLI, not the desktop app. Homebrew declares no additional formula dependency for this cask and declares conflicts with 1password-cli@1 and 1password-cli@beta; these alternative casks also provide op and should not be installed alongside this one.

Accounts, cost, and license

Using personal vaults requires a 1Password account and subscription; service-account access depends on the account's available features and permissions. Subscription plans, trials, and business terms are defined by 1Password. The CLI is proprietary software distributed under 1Password's applicable terms; the separate open-source Shell Plugins project does not establish the license of the complete CLI. A public source repository for the complete CLI was not identified.

op run output masking is best-effort and does not guarantee that secrets are concealed. Avoid logging secrets or committing generated secret-containing files.

Official references: CLI overview, getting started, release notes, and terms of service.

At a glance

Chip
Apple silicon · Intel
Auto-updates
No
Developer
1Password (AgileBits Inc.)
Homebrew
Available; updated by Homebrew
Also known as
1password-cli
Homepage
developer.1password.com/docs/cli
Token
1password-cli

Checked

OpenNavo: virus scanning and an app firewall

The OpenNavo app scans downloads and your whole Mac with ClamAV, and checks startup items and app signatures. Free and open source.

What’s new in 2.42.0

New · OpenNavo editorial

1Password CLI 2.42.0 adds the generally available op environment secret list command and a set of new shell plugins.

How to install 1Password CLI on Mac

Install without Homebrew

Download the file Homebrew uses for your chip: Install Details

Uninstall 1Password CLI and optional data cleanup

Uninstall command
brew uninstall --cask 1password-cli

A regular uninstall removes the app and keeps its settings and caches.

Deep clean (optional)
Uninstall command
brew uninstall --zap --cask 1password-cli

--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.

Questions about 1Password CLI

Is 1Password CLI safe?

1Password CLI is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from cache.agilebits.com against its SHA-256 checksum. It was installed 27,273 times through Homebrew in the last 30 days.

How do I completely uninstall 1Password CLI on a Mac?

Run brew uninstall --cask 1password-cli. To delete its settings and caches as well, run brew uninstall --zap --cask 1password-cli. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes ~/.config/op.

Does 1Password CLI run on Apple silicon (M1 and later) Macs?

Yes. Homebrew downloads separate builds for Apple silicon and Intel Macs.

Where does 1Password CLI store its settings and data?

Its data is in ~/.config/op. These locations come from Homebrew’s clean-up list.

What is the latest version of 1Password CLI?

The latest version is 2.42.0, added to Homebrew on Nov 4, 2026. Run brew upgrade --cask 1password-cli to update it. Homebrew also offers 1password-cli@1 and 1password-cli@beta, which cannot be installed alongside it.

What else does installing 1Password CLI add?

It also adds 1 command-line tool: op.

Similar Apps

  • Git Credential ManagerA free Git credential helper with secure token storage, OAuth and multi-factor sign-in for popular repository hosts.
  • 1PasswordPassword and passkey manager for securely organizing logins, payment cards, notes and shared vaults, with Mac Autofill and optional developer integrations.
  • BitwardenPassword-manager desktop app for encrypted vaults, account switching, password generation and supported biometric/browser integration.
  • KeePassXCFree desktop password manager with local encrypted KDBX databases, password generation, browser integration, Auto-Type, TOTP and passkeys.
Browse all apps