https://github.com/askonomm/shh
A CLI password manager designed for efficiency.
https://github.com/askonomm/shh
cli clojure password-manager
Last synced: 10 months ago
JSON representation
A CLI password manager designed for efficiency.
- Host: GitHub
- URL: https://github.com/askonomm/shh
- Owner: askonomm
- License: mit
- Created: 2021-10-12T03:11:15.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-11-02T00:45:46.000Z (about 4 years ago)
- Last Synced: 2025-04-10T12:51:14.563Z (10 months ago)
- Topics: cli, clojure, password-manager
- Language: Clojure
- Homepage:
- Size: 58.6 KB
- Stars: 22
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Shh
A CLI password manager designed for efficiency.
## Install
### Linux & Mac OS
#### Locally
```shell
curl -s https://raw.githubusercontent.com/askonomm/shh/master/installer.sh | bash -s
```
You can then run Shh as `./shh`, given that the Shh executable is in the current working directory.
#### Globally
```shell
curl -s https://raw.githubusercontent.com/askonomm/shh/master/installer.sh | bash -s -- -g
```
You can then run Shh as `shh` from anywhere.
### Windows
#### Scoop
If you have [Scoop installed and required buckets added](https://github.com/littleli/scoop-clojure/wiki/Getting-started-VERY-QUICKLY) then you can simply run `scoop install shh`, and Shh will be available as `shh` from anywhere.
#### Download executable
[Download shh.exe from the latest release](https://github.com/askonomm/shh/releases/latest), then move it to somewhere on PATH and run it as `shh` from anywhere.
## Usage
### Finding and creating passwords
To start, simply run `shh`. It will then prompt you for a name of a password, and if one isn't found, offers to create
one with that name. Whenever you create a new password, Shh will ask for a desired length of a password as well, which
is convenient for services that have strict rules on the length of password they accept.
To list the names of all existing passwords, run `shh list`.
**Note:** All passwords are stored in a `.shh.edn` file in the user' home directory, unencrypted. This means that your
passwords will only be as safe as your computer. I might add some form of encryption later on (or you can make a PR!),
but for now it's not a priority for me.
### Changing passwords
To change an existing password, run `shh change {name}`.
### Deleting passwords
To delete a password, run `shh delete {name}`.