https://github.com/biox/pa

a simple password manager. encryption via age, written in portable posix shell
https://github.com/biox/pa

Last synced: 2 days ago
JSON representation

a simple password manager. encryption via age, written in portable posix shell

• Host: GitHub
• URL: https://github.com/biox/pa
• Owner: biox
• License: other
• Created: 2021-01-28T22:45:35.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-15T13:00:41.000Z (about 2 months ago)
• Last Synced: 2024-09-15T14:29:22.754Z (about 2 months ago)
• Language: Shell
• Homepage: https://passwordass.org
• Size: 80.1 KB
• Stars: 506
• Watchers: 9
• Forks: 21
• Open Issues: 3
• Metadata Files:
  • Readme: README
  • License: LICENSE

Awesome Lists containing this project

• my-awesome-github-stars - biox/pa - a simple password manager. encryption via age, written in portable posix shell (Shell)
• awesome-age - pa

README

        
                   pa

        a simple password manager

         https://passwordass.org

  features

    - encryption implemented using age[1]

    - automatic key generation

    - automatic git tracking

    - multiple identity/recipient support

    - written in portable posix shell

    - simple to extend

    - only ~160 lines of code

    - pronounced "pah" - as in "papa"

  dependencies

    - age

    - age-keygen

    - git (optional)

  usage

    pa

      a simple password manager

    commands:

      [a]dd  [name] - Add a password entry.

      [d]el  [name] - Delete a password entry.

      [e]dit [name] - Edit a password entry with vi.

      [g]it  [cmd]  - Run git command in the password dir.

      [l]ist        - List all entries.

      [s]how [name] - Show password for an entry.

    env vars:

      password dir:     export PA_DIR=~/.local/share/pa/passwords

      password length:  export PA_LENGTH=50

      password pattern: export PA_PATTERN=A-Za-z0-9-_

      disable tracking: export PA_NOGIT=

  command examples

    $ pa add test

    Generate a password? [y/N]: y

    Saved 'test' to the store.

    $ pa list

    test

    $ pa show test

    vJwKuEBtxBVvdR-xppTdfofIei0oLlkoSK4OCSP2bMEBsP6ahM

    $ pa edit test

    

    $ pa del test

    Delete password 'test'? [y/N]: y

    $ pa git log --oneline

    bbe85dc (HEAD -> main) delete 'test'

    b597c04 edit 'test'

    cba20cc add 'test'

    ef76f7e initial commit

  faq

    > how does this differ from pass, passage, etc?

      pa is smaller. simpler. cleaner. plainer.

      harder. better. faster. stronger.

      more than ever, hour after hour

      work is never over

    > is pa secure?

      if you would like to understand the

      security characteristics of pa, please

      read my blog post[2], and my explanation[3].

    > why u make this?

      see [2].

    > where are my keys?

      probably the default locations:

        ~/.local/share/pa/identities

        ~/.local/share/pa/recipients

    > where are my passwords?

      probably the default location:

        ~/.local/share/pa/passwords

    > how do i rename a password?

      cd ~/.local/share/pa/passwords

      mv foo.age bar.age

  credits

    - pa was originally forked from pash[4] by dylanaraps[5]

    - age[1] is a project by Filippo Valsorda[6]

  refs

    [1]: https://age-encryption.org

    [2]: https://j3s.sh/thought/storing-passwords-with-age.html

    [3]: https://github.com/biox/pa/issues/10#issuecomment-1369225383

    [4]: https://github.com/dylanaraps/pash

    [5]: https://github.com/dylanaraps

    [6]: https://filippo.io