
Una herramienta CLI ligera para buscar y acceder interactivamente a las entradas de tu base de datos KeePassXC usando fzf. Rápida, segura y centrada en la terminal.
Interfaz de terminal interactiva para gestionar bases de datos KeePass usando keepassxc-cli y fzf.

keepassxc-cli - Cliente de línea de comandos de KeePassXCfzf - Buscador difuso de línea de comandosbash - Shell de 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 [OPCIONES] [database.kdbx]
Opciones:
-h, --help Muestra ayuda
-k, --keyfile ARCHIVO Usar archivo clave
Variables de entorno:
KPDB Ruta a la base de datos KeePass
KPKF Ruta al archivo clave
Precedencia (de mayor a menor):
1. Argumentos de CLI (-k, ruta de la base de datos)
2. Variables de entorno (KPDB, KPKF)
Nota: KPKF solo se hereda del entorno cuando la base de datos también
proviene de KPDB. Si pasas una ruta de base de datos en la CLI, las
credenciales del entorno se ignoran para evitar mezclar credenciales de
diferentes bases de datos.
La contraseña maestra siempre se introduce interactivamente y nunca se
lee del entorno.
# Uso básico
keepassxc-fzf ~/passwords.kdbx
# Con archivo clave
keepassxc-fzf -k ~/key.key ~/passwords.kdbx
# Usando variables de entorno
export KPDB="$HOME/passwords.kdbx"
export KPKF="$HOME/key.key"
keepassxc-fzf
| Tecla | Acción |
|---|---|
Ctrl+P | Copiar contraseña (se borra en 10s) |
Ctrl+U | Copiar usuario (se borra en 30s) |
Ctrl+L | Copiar URL (se borra en 30s) |
Ctrl+N | Copiar notas (se borra en 30s) |
Alt+S | Mostrar contraseña en pantalla |
Enter | Copiar contraseña y salir |
ESC | Salir |
La navegación estándar de fzf también funciona (Ctrl+J/Ctrl+K, flechas, escribir para buscar).
*****.chmod 600, no a través de variables de entorno, por lo que no es visible en /proc/<pid>/environ.trap.keepassxc-cli no encontrado: Instala KeePassXC (sudo apt install keepassxc)
fzf no encontrado: Instala fzf (sudo apt install fzf)
El portapapeles no funciona: Instala xclip (sudo apt install xclip) o wl-clipboard para Wayland
La base de datos no se abre: Verifica la contraseña, la ruta del archivo y la ruta del archivo clave si se usa
MIT