
Uma ferramenta CLI leve para pesquisar e acessar interativamente suas entradas do banco de dados KeePassXC usando fzf. Rápida, segura e centrada no terminal.
Interface de terminal interativa para gerenciar bancos de dados KeePass usando keepassxc-cli e fzf.

keepassxc-cli - Cliente de linha de comando do KeePassXCfzf - Fuzzy finder de linha de comandobash - Shell Unixxclip (X11)wl-copy (Wayland)pbcopy (macOS)# Install to /usr/local/bin (requires sudo)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | sudo bash
# Or install to ~/.local/bin (no sudo required)
curl -fsSL https://raw.githubusercontent.com/creusvictor/keepassxc-fzf/main/install.sh | PREFIX=~/.local bash
# Debian/Ubuntu
sudo apt install keepassxc fzf xclip
# Arch Linux
sudo pacman -S keepassxc fzf xclip
# Fedora
sudo dnf install keepassxc fzf xclip
# macOS
brew install keepassxc fzf
git clone https://github.com/creusvictor/keepassxc-fzf.git
cd keepassxc-fzf
# Install to /usr/local/bin (requires sudo)
sudo make install
# Or install to ~/.local/bin
make install PREFIX=~/.local
sudo make uninstall
# Or: make uninstall PREFIX=~/.local
keepassxc-fzf [OPTIONS] [database.kdbx]
Options:
-h, --help Mostrar ajuda
-k, --keyfile FILE Usar arquivo de chave
Environment variables:
KPDB Caminho para o banco de dados KeePass
KPKF Caminho para o arquivo de chave
Precedence (highest to lowest):
1. Argumentos de CLI (-k, caminho do banco de dados)
2. Variáveis de ambiente (KPDB, KPKF)
Note: KPKF é herdado do ambiente apenas quando o banco de dados também vem de KPDB. Se você passar um caminho de banco de dados na CLI, as credenciais do ambiente são ignoradas para evitar misturar credenciais de diferentes bancos de dados. A senha mestra é sempre inserida interativamente e nunca é lida do ambiente.
# Basic usage
keepassxc-fzf ~/passwords.kdbx
# With keyfile
keepassxc-fzf -k ~/key.key ~/passwords.kdbx
# Using environment variables
export KPDB="$HOME/passwords.kdbx"
export KPKF="$HOME/key.key"
keepassxc-fzf
| Tecla | Ação |
|---|---|
Ctrl+P | Copiar senha (limpa em 10s) |
Ctrl+U | Copiar nome de usuário (limpa em 30s) |
Ctrl+L | Copiar URL (limpa em 30s) |
Ctrl+N | Copiar notas (limpa em 30s) |
Alt+S | Mostrar senha na tela |
Enter | Copiar senha e sair |
ESC | Sair |
Navegação padrão do fzf também funciona (Ctrl+J/Ctrl+K, setas, digitar para pesquisar).
*****chmod 600, não via variáveis de ambiente, então não fica visível em /proc/<pid>/environtrapkeepassxc-cli não encontrado: Instale o KeePassXC (sudo apt install keepassxc)
fzf não encontrado: Instale o fzf (sudo apt install fzf)
Área de transferência não funcionando: Instale o xclip (sudo apt install xclip) ou wl-clipboard para Wayland
Banco de dados não abre: Verifique a senha, o caminho do arquivo e o caminho do arquivo de chave, se usado
MIT