Instalación

kovra se compone de dos piezas:

• kovra — el CLI en Rust y la bóveda local (esta es la herramienta principal).
• kovra-mcp — un paquete Python opcional que expone kovra a agentes de IA mediante MCP. Solo lo necesitas para usar kovra desde Claude Code (u otro cliente MCP).

Soporte de plataformas

macOS en Apple Silicon es la plataforma de referencia — autenticación biométrica nativa e integración con Keychain. Windows (Windows Hello + Credential Manager) y Linux están en el roadmap, detrás de los mismos traits; las pestañas de Windows a continuación muestran lo que viene. Los ejemplos asumen macOS por ahora.

Instalar el CLI

Homebrew (recomendado)

macOS

zsh

~ % brew install kaeus-inc/kovra/kovra

Windows

Windows — próximamente. Se está preparando un paquete para scoop/winget.

Esto instala el binario kovra y lo agrega a tu PATH. Verifica la instalación:

macOS

zsh

~ % kovra --version
kovra 0.8.0

Windows

Windows — próximamente. Se está preparando un paquete para scoop/winget.

crates.io

Cualquier plataforma con una toolchain de Rust puede instalar el CLI directamente desde crates.io — sin necesidad de un tap:

zsh

~ % cargo install kovra

Esto compila e instala el binario kovra en ~/.cargo/bin.

Desde el código fuente

Necesitas una toolchain de Rust reciente (kovra apunta a la edición 2024). Clona el repositorio:

git clone https://github.com/kaeus-inc/kovra-core.git
cd kovra-core

Luego compila el binario de release:

macOS

zsh

~/kovra-core % cargo build --release
   Compiling kovra-core v0.8.0 (…/kovra-core/crates/core)
   Compiling kovra v0.8.0 (…/kovra-core/crates/cli)
    Finished `release` profile [optimized] target(s) in 1m 47s

Windows

Windows — próximamente. Los rieles nativos de biometría + Credential Manager aún no están construidos.

El binario kovra queda en target/release/kovra. Cópialo a algún directorio en tu PATH:

cp target/release/kovra /usr/local/bin/

Instalar el servidor MCP (opcional)

El servidor MCP permite que un agente de IA vea metadatos con alcance limitado y ejecute comandos a través del wrapper de kovra, sin recibir nunca el texto plano de tus secretos sensibles. Se distribuye como el paquete Python kovra-mcp y provee el comando kovra-mcp.

pip install kovra-mcp
# o, aislado en tu PATH:
pipx install kovra-mcp     # o: uv tool install kovra-mcp

Normalmente no ejecutas kovra-mcp a mano — es un servidor MCP stdio que tu agente lanza. kovra setup lo registra para tu proyecto. Solo confirma que está en tu PATH:

macOS

zsh

~ % which kovra-mcp
/Users/you/.local/bin/kovra-mcp

Windows

Windows — próximamente. Usa where.exe kovra-mcp cuando los paquetes de Windows estén disponibles.

Siguiente paso

Dirígete al Inicio rápido para inicializar tu bóveda, almacenar tu primer secreto e inyectarlo en un proceso.