Countersign

A fast, keyboard-first desktop app for Bitwarden on Omarchy and other Hyprland desktops, written in Rust and built on the official Bitwarden CLI. Try quick access in your browser on a fictional vault.

Countersign is an independent project, not affiliated with or endorsed by Bitwarden, Inc. It never implements Bitwarden's encryption and never talks to Bitwarden's servers itself. The official CLI does both; Countersign is the interface and the desktop integration around it.

• Quick access. A launcher-style overlay: type a few letters, press Enter, and the password is on the clipboard. Recent items come first.
• The whole vault. Logins, cards, identities, notes and SSH keys, with folders, organization collections, favorites, archive and trash, and a password and passphrase generator. Secrets stay masked until you reveal them. Verification codes count down live.
• Editing. Create and edit logins, cards, identities and notes, with websites and custom fields; SSH keys keep their key and the rest can be edited. Manage folders and attachments, move items to an organization, archive, trash, restore or delete forever.
• Send. Share text or a file through Bitwarden Send. A new Send's link goes straight to the clipboard.
• A clipboard that cleans up. Copies clear themselves after 30 seconds and are marked so Omarchy's clipboard history skips them. After a password copy, the item's one-time code replaces it a few seconds later.
• Locks when you do. On request, after inactivity, when the screen locks and before the computer sleeps.
• Looks like Omarchy. Follows the active theme's palette and Hyprland's corner rounding, light or dark, and switches with the theme.

Omarchy Flexoki Light	Omarchy Tokyo Night

Editing an item	Send

Screenshots use a fictional demo vault; see scripts/screenshots.sh. Most are in HANCORE's InkyPinky theme for Omarchy.

Early: Countersign is built and tested on Omarchy. The roadmap lists the known limitations, the changelog what each release changed, and Performance has the measurements.

You need Omarchy, on an Intel or AMD (x86_64) or an ARM (aarch64) computer, and a Bitwarden account. On another Hyprland desktop, or to run the latest code, build it from source instead.

1. Download and install. Run these in a terminal:

   mkdir -p ~/Downloads/countersign && cd ~/Downloads/countersign
   arch=$(uname -m)
   curl -LO https://github.com/BVisagie/countersign/releases/latest/download/countersign-$arch.tar.gz
   curl -LO https://github.com/BVisagie/countersign/releases/latest/download/SHA256SUMS
   sha256sum -c --ignore-missing SHA256SUMS && tar xf countersign-$arch.tar.gz && countersign-$arch/scripts/install.sh

   uname -m names your computer's architecture, so the commands download the archive built for it. sha256sum -c checks the download and should say countersign-x86_64.tar.gz: OK (or aarch64 on ARM); if it does not, nothing is unpacked or installed. The install script installs Countersign for your user. Omarchy lacks one library it needs, vte4, so the script offers to install it with pacman, which asks for your password first.

2. Open Countersign from your app launcher, or run countersign.

3. Install the Bitwarden CLI. Countersign never encrypts your vault or talks to Bitwarden's servers itself. Bitwarden's own command-line program, the Bitwarden CLI, does both, and Countersign is the window around it. If it asks, choose Install the official CLI: Countersign downloads it and checks it against a checksum recorded in its source. Countersign works with CLI 2026.10.1 or newer, and installs 2026.10.1.

4. Sign in. Choose your server (US cloud, EU cloud or self-hosted), sign in with your email or an API key, then unlock with your master password. First run explains each choice.

5. Add a key for quick access. Add these lines to your Hyprland configuration:

   -- ~/.config/hypr/bindings.lua
   o.rebind("SUPER + SHIFT + P", "Passwords", "countersign --quick")
   -- ~/.config/hypr/autostart.lua
   o.launch_on_start("countersign --background")

   The first line makes Super+Shift+P open quick access, in place of Omarchy's Google Photos shortcut. Hyprland picks it up when you save. The second starts Countersign when you log in, so quick access opens instantly.

Now press Super+Shift+P, type a few letters of a site and press Enter: the password is on the clipboard, and it clears itself after 30 seconds.

• Installing: requirements, choosing a CLI, updating, uninstalling and troubleshooting.
• Using Countersign: sign-in, quick access, copying, editing, Send, locking and settings.

More in Using Countersign.

See ARCHITECTURE.md and SECURITY.md.

GNU General Public License v3.0 or later.