shell-plugins

1Password Shell Plugins

Authenticate any CLI with your fingerprint

No more plaintext credentials in your home directory. Automatically authenticate every CLI you use with 1Password CLI + Shell Plugins. Approve temporary credential usage in your terminal with biometrics.

By accessing or using 1Password Developer Tools, you agree to the API and SDK Terms of Service.

See it in action!

Get started with the available plugins

See all...

Don’t see yours? Contribute! [BETA]

Is your favorite CLI not listed yet? Learn how to build a new plugin yourself and then open a PR on this repository to get it included in the 1Password CLI!

For the contribution guidelines, see CONTRIBUTING.md.

Quick start: clone or fork this repo and run

make new-plugin

Still not sure where or how to begin? We're happy to help! You can:

• Book a free pairing session with one of our developers
• Join the Developer Slack workspace, and ask us any questions there

Advanced Configuration

Managing shell plugins in your own dotfiles

By default, op plugin init writes its configuration to ~/.config/op/plugins.sh and manages that file for you. If you'd rather keep your plugin configuration in your own dotfiles (for example, tracked in version control), you can define the shell functions yourself and source them in your shell's configuration file.

Step 1: Define the plugin functions

Shell functions for each shell should follow this pattern. In this case,

bash / zsh

gh() {
  op plugin run -- gh "$@"
}

fish

function gh --wraps gh --description "1Password shell plugin for GitHub CLI"
  op plugin run -- gh $argv
end

Step 2: Tell op your plugins are already configured

Set OP_PLUGIN_ALIASES_SOURCED=1 so 1Password CLI knows the shell plugins have already been set up:

bash / zsh

export OP_PLUGIN_ALIASES_SOURCED="1"

fish

set -x OP_PLUGIN_ALIASES_SOURCED 1

Note: op plugin init edits ~/.config/op/plugins.sh directly and won't update your own dotfiles, so configure plugins manually as shown above.

Community & Support

• File an issue for bugs and feature requests
• Join the Developer Slack workspace
• Subscribe to the Developer Newsletter