# 1Password CLI

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

> This is the Markdown version of the 1Password CLI page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/1password-cli>

- **Latest version**: `2.42.0`
- **Developer**: 1Password (AgileBits Inc.)
- **Homepage**: <https://developer.1password.com/docs/cli>
- **Categories**: [Security & Privacy](https://opennavo.com/categories/security)
- **Install**: `brew install --cask 1password-cli`
- **30-day installs**: 27,273
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
- **SHA-256**: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`
- **Commands**: op

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "binary": [
        "op"
      ],
      "target": "$HOMEBREW_PREFIX/bin/op"
    },
    "phase": "install",
    "sources": [
      "op"
    ],
    "target": "$HOMEBREW_PREFIX/bin/op",
    "type": "binary"
  },
  {
    "declaration": {
      "generate_completions_from_executable": [
        "op",
        "completion",
        {
          "base_name": null,
          "shell_parameter_format": null,
          "shells": [
            "bash",
            "zsh",
            "fish"
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [
      "op",
      "completion"
    ],
    "type": "generate_completions_from_executable"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.config/op"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 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](https://www.1password.dev/cli), [getting started](https://www.1password.dev/cli/get-started), [release notes](https://releases.1password.com/developers/cli/), and [terms of service](https://1password.com/legal/terms-of-service).

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 2.42.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · Checked 2026-11-22
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_amd64_v2.42.0.zip>
  - SHA-256: `917b0d2b41de3d943bb6562331275c43c4b525af6b003eade06248905ddd62b0`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 2.42.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · Checked 2026-11-22
  - <https://cache.agilebits.com/dist/1P/op2/pkg/v2.42.0/op_darwin_arm64_v2.42.0.zip>
  - SHA-256: `216e86c6db491c752ccb7819b3b1851cc8456ea015a1f7c8a58dd103ef0a474e`

## Uninstall

- `brew uninstall --cask 1password-cli`

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

### Deep clean (optional)

- `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`.

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

- Files and folders: `~/.config/op` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.42.0 (2026-11-03)

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

1Password CLI 2.42.0 was released on 2026-11-03, adding the generally available `op environment secret list` command and a set of new shell plugins.

- `op environment secret list` is now generally available; it lists the name and value of each secret in a 1Password Environment, and whether each secret is concealed.
- New shell plugins add Touch ID and other unlock options for the Stackhero CLI, npm and pnpm, the Octopus Deploy CLI, the Doppler CLI, the CockroachDB CLI (`cockroach sql`), the LocalXpose CLI (`loclx`), the DuckDB CLI with MotherDuck, the Postman CLI, the Spacelift CLI (`spacectl`), the Netlify CLI, the xAI Grok CLI, and the OpenBao CLI (`bao`).
- The Argo CD plugin now supplies credentials only when `argocd` targets the server stored in the item's Address, so `--argocd-context` and `--server` behave as they do without the plugin.
- The Akamai and Pipedream plugins refuse to write credential values containing line breaks into their generated config files.
- The Sourcegraph plugin supports the current `sgp_` token format and now requires the Endpoint field.
- The Hugging Face plugin uses the `hf` command instead of `huggingface-cli`; run `op plugin init hf` and remove the old alias.
- The LocalStack plugin uses `LOCALSTACK_AUTH_TOKEN` instead of the deprecated `LOCALSTACK_API_KEY`.
- `op item get`, `op read`, `op run`, and `op inject` now return an address field's value when some parts of the address, such as the street or country, are empty.
- The MySQL plugin quotes and escapes values written to `my.cnf`, so passwords containing `#`, backslashes, or surrounding whitespace authenticate correctly.
- The OpenTofu plugin supplies credentials to `tofu workspace` commands, matching the Terraform plugin.
- The AWS plugin no longer fails with "Cannot call GetSessionToken with session credentials" when a profile with MFA assumes a role through a `source_profile`.

[Official release notes](https://app-updates.agilebits.com/product_history/CLI2)

## Facts and sources

- <https://opennavo.com/apps/1password-cli>
- <https://opennavo.com/apps/1password-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/1/1password-cli.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/1password-cli>
