clipsafe logo


A Command Line Interface to Password Safe
| Description | Download | Usage | Commands |


cliPSafe is a command line interface (cli) to Password Safe databases. cliPSafe only works with version 3 databases and it currently only operates in read only mode. Password Safe was originally written by Bruce Schneier and is now run as an open source project hosted on SourceForge.

cliPSafe is written in Perl and requires that the following CPAN modules be installed:

Everything else you need should come standard with your Perl installation. I've imported perl code from Crypt::Pwsafe, by Shufeng Tan, and the core module Term::Complete, by Wayne Thompson, in order to make small modifications.

Please send all questions, comments, suggestions to me! Copyright (C) 2008 Ross Palmer Mohn, Licensed under the GNU GPLv2 for now.



    clipsafe [-f dbfname] [rxp]

If you just want to look up a single entry in the database, the quickest way is to put the entry name (or a matching regular expression) right on the command line. For example: clipsafe mybank. It's treated the same as if you were in the application and entered show -l mybank. You will be prompted for your master password, and then the entry will be displayed.

You can specify the psafe database path on the command line using the -f switch. By default, the program looks in ~/.passwordsafe/ for your most recently used file. If neither of those methods work, the program prompts you to enter the path.


    Valid commands are:
        ls [group]      - list groups & entries
        cg <group>      - change group (root = /)
        show [-l] <rxp> - show an entry, use -f to treat db as a flat list
        exit            - exit clipsafe

    Commands ls and cg support tab completion on group names


The ls command displays a list of entries. If you are at the top level, then it displays a list of groups, then a list of top level entries.


The cg command is used to change from the top level into a specific group. To get back to the top level, enter the command cg /. The command cd is a synonym for cg.


The show command displays all the information about an entry. You specify the name of the entry, or you can specify a regular expression to match the name of the entry. If there is more than one entry that matches the regular expression, it will print all the matches and prompt you to enter the number of the one you want, or 0 (zero) to cancel.

Using the -l switches tells cliPSafe to treat the database of entries as a single, flat list of entries rather than a hierarchy of sub-groups. This is useful if you know the entry name but aren't sure which group it is filed under.


The exit command exits the program. You can use quit as well.