keepassxc-fzf

Interfaz de terminal interactiva para gestionar bases de datos KeePass usando keepassxc-cli y fzf.

Características

• Búsqueda interactiva de entradas con buscador difuso (fzf)
• Vista previa en tiempo real de la entrada (contraseña oculta)
• Copiar al portapapeles con borrado automático:
  • Contraseña (10 segundos)
  • Usuario, URL, Notas (30 segundos)
• Soporte para archivos de clave
• Configuración mediante variables de entorno
• Soporte de portapapeles multiplataforma (xclip, wl-copy, pbcopy)

Requisitos

Obligatorios

• keepassxc-cli - Cliente de línea de comandos de KeePassXC
• fzf - Buscador difuso de línea de comandos
• bash - Shell de Unix

Opcionales (portapapeles)

• xclip (X11)
• wl-copy (Wayland)
• pbcopy (macOS)

Instalación

Instalación rápida (recomendada)

# 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

Dependencias

# 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

Instalación manual (desde el código fuente)

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

Desinstalación

sudo make uninstall
# Or: make uninstall PREFIX=~/.local

Uso

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.

Ejemplos

# 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

Atajos de teclado

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).

Seguridad

• El portapapeles se borra automáticamente tras el tiempo de espera.
• La entrada de la contraseña siempre es interactiva: nunca se lee de variables de entorno.
• La vista previa oculta las contraseñas con *****.
• La contraseña maestra se pasa a los subprocesos de fzf mediante un archivo temporal con chmod 600, no a través de variables de entorno, por lo que no es visible en /proc/<pid>/environ.
• El archivo temporal de contraseña se elimina al salir mediante un trap.

Solución de problemas

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

Licencia

MIT