Volver a actualizaciones
Nuevo releaseAug 27, 2026

cottage v0.7.0

Un moderno gestor de secretos cifrados con age basado en git para equipos.

Compartir

El logotipo de cottage

Cottage Verify Cottage Rotate Crates.io Version PyPI Version NPM Version Docker Image Version

cottage es una herramienta GitOps para que los equipos gestionen secretos cifrados con age en repositorios git.

Proporciona un flujo de trabajo sencillo para cifrar/descifrar secretos, gestionar destinatarios y mantener los secretos fuera del repositorio, a la vez que permite compartirlos fácilmente mediante VCS. cottage también genera vistas previas censuradas de los secretos cifrados para una mejor visibilidad y admite flujos de trabajo de descifrado tanto persistentes como temporales, garantizando que los secretos nunca se confirmen en texto plano.

Intro Demo

  1. Características
  2. Instalación
  3. Integraciones con editores
    1. Extensión de VS Code
    2. Extensión para Cursor y Eclipse
    3. Plugin de Vim
  4. Integraciones con agentes de IA
  5. Inicio rápido
  6. GitOps
  7. Git Hooks
  8. Prefijos de ruta
  9. Control de acceso
    1. Reglas
    2. Verificación
  10. Cualquier proveedor como upstream
    1. Plugins de ejemplo
  11. Sincronización con cualquier dispositivo
  12. Más información
  13. Solución de problemas
  14. Comparación
    1. age frente a otros cifrados
    2. cottage frente a SOPS
    3. cottage frente a dotenvx
    4. cottage frente a agebox

Características

  • Seguro para la exposición: Utiliza el sistema de tipos de Rust para garantizar que los errores nunca puedan exponer secretos accidentalmente.
  • Compatible con equipos: Comparte claves públicas (destinatarios) en el repositorio, mantén las claves privadas (identidades) en local.
  • Control de acceso: Reglas simples de permitir/denegar para controlar qué secretos se cifran para qué destinatarios.
  • Gestiona .gitignore: Actualiza automáticamente .gitignore para mantener los secretos sin cifrar fuera del repositorio.
  • Previsualizaciones: Genera previsualizaciones censuradas con marca de tiempo de los secretos cifrados para una mejor visibilidad.
  • Diffs enriquecidos: Mantiene el git diff limpio y revisable, mientras que ctg diff muestra el diff de los secretos modificados localmente con sus contrapartes cifradas rastreadas.
  • Verificación de checksum: Evita la manipulación verificando que los secretos cifrados y las listas de destinatarios coincidan con los metadatos.
  • Git hooks: Configura fácilmente git hooks para verificar/cifrar automáticamente los secretos antes del commit y descifrarlos después del checkout.
  • Prefijos de ruta: Opcionalmente almacena los secretos cifrados y los metadatos en directorios dedicados, en lugar de junto a los archivos descifrados.
  • Flujo de trabajo de secretos persistentes: ctg decrypt/sync mantiene los secretos descifrados en disco.
  • Ciclo de vida de limpieza inteligente: ctg run (atajo ctgx) y ctg edit descifran los secretos antes de la operación, manteniéndolos en disco si ya estaban presentes de antemano o limpiándolos automáticamente después si no lo estaban.
  • Limpieza al finalizar: ctg encrypt --clean, ctg run --clean y ctg edit --clean garantizan que los archivos descifrados se limpien del disco incluso si estaban presentes antes.
  • Flujo de trabajo de inyección de entorno: ctg env inyecta los secretos descifrados como variables de entorno para ejecutar un comando, sin escribirlos en disco en absoluto.
  • Tubería segura de secretos: ctg cat descifra en memoria e imprime a stdout para canalizar directamente por stdin a otras herramientas. ctg tee cifra stdin en PATH sin escribir texto plano en disco. ctg rotate vuelve a cifrar los secretos existentes para los destinatarios actuales, también sin escribir texto plano en disco.
  • Limpieza: ctg clean elimina todos los secretos descifrados del repositorio local para que puedas ejecutar tus agentes de IA con un poco menos de preocupación.
  • Compatible con jj y directorios no-git: ctg init convierte cualquier directorio en un almacén de secretos.
  • Sincronización con cualquier proveedor: Te permite configurar cualquier proveedor con una API como upstream, y empezar a usar ctg pull/diff/push como git pull/diff/push.
  • Sincronización con cualquier dispositivo: Los secretos cifrados con cottage y gestionados en un repositorio git se pueden sincronizar entre dispositivos con Cottage Sync.

Instalación

Descarga directamente el binario

O instala desde un registro de paquetes:

# rust: cargo-binstall/cargo
cargo binstall --locked cottage
cargo install --locked cottage

# python: pip/uv/uvx
pip install cottage
uv pip install cottage
uvx --from cottage ctg --version

# node: yarn/pnpm/npx
yarn global add @sayanarijit/cottage
pnpm add -g @sayanarijit/cottage
npx -p @sayanarijit/cottage ctg --version

También disponible como imágenes de docker:

# Docker
docker run --rm -v $PWD:/app sayanarijit/cottage --version

# Podman
podman run --rm -v $PWD:/app quay.io/sayanarijit/cottage --version

O descarga la última versión desde GitHub.

Integraciones con editores

Extensión de VS Code

Usa la extensión Cottage para VS Code para instalar ctg, añadir hooks de seguridad de Copilot, cifrar archivos desde el Explorador y abrir archivos .cott.age a través del flujo de trabajo del editor.

Cottage VS Code Extension Demo

Instálala desde Visual Studio Marketplace, o compílala e instálala localmente desde vscode-plugin-cottage.

Extensión para Cursor y Eclipse

Categorías