Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kbsecret/kbsecret
A secret manager backed by Keybase and KBFS.
https://github.com/kbsecret/kbsecret
keybase password-manager ruby secret-management
Last synced: 2 months ago
JSON representation
A secret manager backed by Keybase and KBFS.
- Host: GitHub
- URL: https://github.com/kbsecret/kbsecret
- Owner: kbsecret
- License: mit
- Archived: true
- Created: 2017-02-03T02:39:03.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-29T22:31:19.000Z (over 3 years ago)
- Last Synced: 2024-08-04T04:09:04.814Z (6 months ago)
- Topics: keybase, password-manager, ruby, secret-management
- Language: Ruby
- Homepage: https://kbsecret.github.io
- Size: 904 KB
- Stars: 435
- Watchers: 7
- Forks: 17
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
========
[](https://badge.fury.io/rb/kbsecret)
[](https://travis-ci.org/kbsecret/kbsecret)
[](https://codecov.io/gh/kbsecret/kbsecret)
**Warning**: KBSecret is currently maintained on a best-effort basis. PRs are **strongly**
preferred over new issues.
KBSecret is a command line utility and library for managing *secrets*.
Quick links:
* [Installation instructions](https://kbsecret.github.io/#/install/)
* [Quick start guide](https://kbsecret.github.io/#/quickstart/)
* [CLI documentation](https://kbsecret.github.io/man/kbsecret.1.html)
* [API documentation](http://www.rubydoc.info/gems/kbsecret/)
* [Customizing your installation](https://kbsecret.github.io/#/customize/)
## Hacking on KBSecret
Want to hack on KBSecret? Here's how you can get started:
```bash
$ git clone [email protected]:kbsecret/kbsecret.git && cd kbsecret
$ bundle install --path vendor/bundle
$ bundle exec ./bin/kbsecret help
```
### Manual Pages
KBSecret's manual pages can be found online
[here](https://kbsecret.github.io/man/kbsecret.1.html).
If you'd like to generate the roff versions for `man(1)`, you'll need `ronn(1)`:
```bash
$ bundle exec make man
$ cp man/*.1 ${YOUR_MAN_DIR}
```
### Shell Completion
KBSecret provides shell completion functions for bash, zsh, and fish.
To generate the completions for Bash:
```bash
$ bundle exec make bash
$ # or, if you have additional commands that support --introspect-flags:
$ CMDS='foo bar baz' bundle exec make bash
$ cp completions/kbsecret.bash ${YOUR_COMPLETION_DIR}
```
To use the completions for zsh, add the completions directory to your `$fpath` or copy the
`completions/_kbsecret` file to any of the directories in it.
To use the fish completions, copy `completions/kbsecret.fish` to your `~/.config/fish/completions` folder.
Please feel free to contribute completion scripts for other shells!
### Contributing
See ["help wanted"](https://github.com/kbsecret/kbsecret/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
on the [issue tracker](https://github.com/kbsecret/kbsecret/issues).
If you have an idea for a new feature, please suggest it! Pull requests are also welcome.
### Community and Help
If you'd like help or would just like to chat about KBSecret's development, please
join us in `#kbsecret` on Freenode.
We also have a Keybase team. Please let us know on IRC if you'd like to be added to it.
## Licensing
KBSecret is licensed under the MIT License.
KBSecret's logo was created by [Arathnim](http://arathnim.me).