Need help with tmux-1password?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

157 Stars 11 Forks MIT License 17 Commits 7 Opened issues


:key: Access your 1Password login items within tmux!

Services available


Need anything else?

Contributors list


Build Status

Access your 1Password login items within tmux!

This plugin allows you to access you 1Password items within tmux, using 1Password's CLI. It works for personal 1Password accounts, as well as teams accounts.


This plugin relies on the following:

Key bindings

In any tmux mode:

  • prefix + u
    - list login items in a bottom pane.


Using Tmux Plugin Manager (recommended)

  1. Add plugin to the list of TPM plugins in

    set -g @plugin 'yardnsm/tmux-1password'
  2. Hit

    prefix + I
    to fetch the plugin and source it. You should now be able to use the plugin.

Manual Installation

  1. Clone this repo:

    $ git clone ~/some/path
  2. Source the plugin in your

    by adding the following to the bottom of the file:
    run-shell ~/some/path/plugin.tmux
  3. Reload the environment by running:

    $ tmux source-file ~/.tmux.conf


First, sign in with 1Password CLI by running the following in your terminal (you only need to do this once):

$ op signin   

For 1Password personal accounts,

 should be
. If you're using a team account, configure the

From now on, initiate the plugin by using the keybind (

prefix + u
by default). A new pane will be opened in the bottom, listing the appropriate login items. Press
 to choose a login item,
and its password will automatically be filled.

You may be required to perform a re-login (directly in the opened pane) since the 1Password CLI's sessions expires automatically after 30 minutes of inactivity.


Customize this plugin by setting these options in your

file. Make sure to reload the environment afterwards.

Changing the default key-binding for this plugin

set -g @1password-key 'x'



Setting the signin subdomain

set -g @1password-subdomain 'acme'



Setting the default vault

set -g @1password-vault 'work'


(all vaults)

Copy the password to clipboard

By default, the plugin will use

to send the selected password to the targeted pane. By setting the following, the password will be copied to the system's clipboard, which will be cleared after 30 seconds.
set -g @1password-copy-to-clipboard 'on'



Customize URL Filtering

By default, all of the items will be shown. If complete customization of url filtering is required, a

filter can be provided to filter and map items.

Items come in the following format from which the filter operates:

    "uuid": "some-long-uuid",
    "overview": {
      "URLs": [
        { "u": "sudolikeaboss://local" }
      "title": "Some item",
      "tags": ["some_tag"]




Filtering by tags

The following example will filter only the items that has a tag with a value of

set -g @1password-items-jq-filter '
  .[] \
  | [select(.overview.tags | map(select(. == "some_tag")) | length == 1)?] \
  | map([ .overview.title, .uuid ] \
  | join(",")) \
  | .[] \
Filtering by custom url

The following example will filter only the items that has a website field with the value of

, similar to the way sudolikeaboss used to work.
set -g @1password-items-jq-filter ' \
  .[] \
  | [select(.overview.URLs | map(select(.u == "sudolikeaboss://local")) | length == 1)?] \
  | map([ .overview.title, .uuid ] \
  | join(",")) \
  | .[] \

Prior art

Also see:


MIT © Yarden Sod-Moriah

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.