2Pass CLI

Build Status

A super simple CLI to access secrets.

The objective is to have a shared password manager that can be integrated with Kamal deployment tool.

Getting started

  mkdir ~/.2pass/

Create a vault file with the following data structure. An array of hashes with the following keys:

  • id
  • value
  • uuid
  touch ~/.2pass/vault_name.yml

Alternatively, if you have a vault file in a different location, you can link it.

  2pass link vault_name /path/to/vault_name.yml

Then build the gem and install it.

  gem build 2pass.gemspec
  gem install 2pass-0.1.0.gem

Usage

  2pass -h
  2pass get <vault_name> <id>
  2pass list <vault_name>
  2pass add <vault_name> <id> <value>

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

To experiment with that code, run bin/console for an interactive prompt.

Testing

Run tests locally

rake test TEST=**/*/example_test.rb
rake test
DEBUG=1 rake test

License

The gem is available as open source under the terms of the MIT License.