Torna agli aggiornamenti
New releaseAug 27, 2026

cottage v0.7.0

Un moderno gestore di segreti per team, basato su git e cifrato con age.

Condividi

Il logo di cottage

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

cottage è uno strumento GitOps per i team per gestire segreti cifrati con age nei repository git.

Fornisce un flusso di lavoro semplice per cifrare/decifrare i segreti, gestire i destinatari e mantenere i segreti fuori dal repository consentendo comunque una facile condivisione tramite VCS. cottage genera inoltre anteprime oscurate dei segreti cifrati per una migliore visibilità e supporta sia flussi di lavoro di decifratura persistenti che temporanei, garantendo al contempo che i segreti non vengano mai committati in chiaro.

Intro Demo

  1. Funzionalità
  2. Installazione
  3. Integrazioni con l'editor
    1. Estensione VS Code
    2. Estensione Cursor ed Eclipse
    3. Plugin Vim
  4. Integrazioni con agenti AI
  5. Avvio rapido
  6. GitOps
  7. Git Hooks
  8. Prefissi dei percorsi
  9. Controllo degli accessi
    1. Regole
    2. Verifica
  10. Qualsiasi provider come upstream
    1. Plugin di esempio
  11. Sincronizzazione con qualsiasi dispositivo
  12. Scopri di più
  13. Risoluzione dei problemi
  14. Confronto
    1. age vs altre crittografie
    2. cottage vs SOPS
    3. cottage vs dotenvx
    4. cottage vs agebox

Funzionalità

  • Sicuro rispetto all'esposizione: sfrutta il sistema di tipi di Rust per garantire che i bug non possano mai esporre accidentalmente i segreti.
  • Adatto al lavoro di squadra: condividi le chiavi pubbliche (destinatari) nel repository, mantieni le chiavi private (identità) in locale.
  • Controllo degli accessi: semplici regole di autorizzazione/negazione per controllare quali segreti vengono cifrati per quali destinatari.
  • Gestisce .gitignore: aggiorna automaticamente .gitignore per tenere i segreti non cifrati fuori dal repository.
  • Anteprime: genera anteprime oscurate con marca temporale dei segreti cifrati per una migliore visibilità.
  • Diff ricchi: mantiene il git diff pulito e revisionabile, mentre ctg diff mostra il diff dei segreti modificati localmente rispetto alle controparti cifrate tracciate.
  • Verifica del checksum: impedisce manomissioni verificando che i segreti cifrati e gli elenchi dei destinatari corrispondano ai metadati.
  • Hook di git: configura facilmente hook di git per controllare/cifrare automaticamente i segreti prima del commit e decifrarli dopo il checkout.
  • Prefissi di percorso: memorizza opzionalmente i segreti cifrati e i metadati in directory dedicate, invece che accanto ai file decifrati.
  • Flusso di lavoro con segreti persistenti: ctg decrypt/sync mantiene i segreti decifrati su disco.
  • Ciclo di pulizia intelligente: ctg run (scorciatoia ctgx) e ctg edit decifrano i segreti prima dell'operazione, mantenendoli su disco se erano già presenti in precedenza o ripulendoli automaticamente in seguito se non lo erano.
  • Pulizia al completamento: ctg encrypt --clean, ctg run --clean e ctg edit --clean garantiscono che i file decifrati vengano rimossi dal disco anche se erano presenti in precedenza.
  • Flusso di lavoro con iniezione nell'ambiente: ctg env inietta i segreti decifrati come variabili d'ambiente per eseguire un comando, senza scriverli affatto su disco.
  • Piping sicuro dei segreti: ctg cat decifra in memoria e stampa su stdout per il piping diretto via stdin verso altri strumenti. ctg tee cifra lo stdin in PATH senza scrivere testo in chiaro su disco. ctg rotate ricifra i segreti esistenti per i destinatari correnti, anch'esso senza scrivere testo in chiaro su disco.
  • Pulizia: ctg clean elimina tutti i segreti decifrati dal repository locale per permetterti di eseguire i tuoi agenti AI con un po' meno preoccupazioni.
  • Supporta jj e directory non-git: ctg init trasforma qualsiasi directory in un archivio di segreti.
  • Sincronizzazione con qualsiasi provider: ti consente di configurare qualsiasi provider con un'API come upstream e di iniziare a usare ctg pull/diff/push come git pull/diff/push.
  • Sincronizzazione con qualsiasi dispositivo: i segreti cifrati con cottage e gestiti in un repository git possono essere sincronizzati tra dispositivi con Cottage Sync.

Installazione

Scarica direttamente il binario

Oppure installa da un registro di pacchetti:

# 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

Disponibile anche come immagini Docker:

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

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

Oppure scarica l'ultima release da GitHub.

Integrazioni con gli editor

Estensione VS Code

Usa l'estensione Cottage per VS Code per installare ctg, aggiungere hook di sicurezza per Copilot, cifrare file dall'Explorer e aprire i file .cott.age tramite il flusso di lavoro dell'editor.

Cottage VS Code Extension Demo

Installala dal Visual Studio Marketplace, oppure compilala e installala localmente da vscode-plugin-cottage.

Estensione Cursor ed Eclipse

Scarica il file VSX e installalo nel tuo IDE Cursor o Eclipse. Funziona in modo simile all'estensione VS Code.

Plugin Vim

Categorie