https://github.com/liouk/opa

opa extends the functionality of 'op' (the 1Password CLI tool) by using fzf and persistent sessions.
https://github.com/liouk/opa

Last synced: about 2 months ago
JSON representation

opa extends the functionality of 'op' (the 1Password CLI tool) by using fzf and persistent sessions.

• Host: GitHub
• URL: https://github.com/liouk/opa
• Owner: liouk
• Created: 2023-08-11T16:55:43.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-07T13:55:03.000Z (6 months ago)
• Last Synced: 2024-10-14T12:11:17.082Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 17.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# :shell: opa

```

opa extends the functionality of 'op' (the 1Password CLI tool) by using fzf and

persistent sessions.

This tool requires:

  - op: https://1password.com/downloads/command-line/

  - fzf: https://github.com/junegunn/fzf

COMMANDS

  signin

      Sign-in to 1password and store the session token in the file specified

      in $OPA_SESSION_FILE. By default, this is '/home/ilias/.config/op/.session-token'.

      The token is valid for 30 minutes.

  list [-c|--choose]

      List all items available in the signed in account; sign-in if needed. Then, if

      the selected item contains only one secret, copy it to the clipboard and send

      a desktop notification. If there are multiple secrets, or '-c' has been used,

      prompt the user to select which field to copy.

  clear

      Delete the session token file.

  help, usage

      Print this help message.

OPTIONS

  -c, --choose

      Instead of automatically copying the secret to clipboard when there is only one

      in the selected item, prompt the user to choose which field to copy. Useful to

      copy 2FA fields such as OTP.

  -h, --help

    Same as 'help' or 'usage' command.

EXTRA COMMANDS

  This section documents any extra commands defined. See section 'EXTRAS DEFINITION'

  for more info.

  test

      A user defined extra command :)

EXTRAS DEFINITION

  This script can be extended to run user defined commands, on top of the ones defined

  here. The commands must be defined as functions in a shell file; the location of the

  file can be set in $OPA_EXTRAS_FILE (defaults to '/home/ilias/.zsh/conf.d/opa-extras.sh').

  Each command must be defined in a function called 'opa_extras_'; for example:

    opa_extras_test () {

      echo "You can invoke this command simply by typing 'opa test'."

    }

  The script first looks at its own commands, and then the extras; therefore you can't

  hijack any command names as they will be evaluated first.

  You can document your extras by writing a func called 'opa_usage_extras' which prints

  the docs within the 'EXTRA COMMANDS' section above. Follow the structure of this doc

  for the best results.

```