/bitw

Minimalist BitWarden client

Primary LanguageGoBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

bitw

A simple BitWarden client. Requires Go 1.19 or later.

go install mvdan.cc/bitw@latest

The goal is a static and portable client which integrates well with one's system. For example, on Linux it implements the org.freedesktop.secrets D-Bus service.

Note that this project isn't being actively developed right now, as I lack the time. I am happy to hand over the repository to whoever can maintain and develop the project, with the only requirement that they make at least two non-trivial contributions first. Other projects with similar goals like https://github.com/quexten/goldwarden might be interesting too, which tackles desktop Bitwarden integration in Go via a GUI and autotype rather than a D-Bus service.

Quickstart

Log in and sync, providing a password when asked:

export EMAIL=you@domain.com
bitw sync

You can then view your secrets:

bitw dump

You can also start the D-Bus service, and use it:

bitw serve
secret-tool lookup name mysecret

Non-goals

These features are not planned at the moment:

  • A graphical interface - use vault.bitwarden.com
  • Querying secrets directly - use D-Bus clients like secret-tool
  • Integration with gnome-keyring - they both implement the same D-Bus service
  • Desktop autotype/autofill integration - it could be built on top of D-Bus secrets

Further reading

Talking to BitWarden:

Integrating with the OS: