
cottage v0.7.0
Un moderno gestore di segreti per team, basato su git e cifrato con age.
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.

- Funzionalità
- Installazione
- Integrazioni con l'editor
- Integrazioni con agenti AI
- Avvio rapido
- GitOps
- Git Hooks
- Prefissi dei percorsi
- Controllo degli accessi
- Qualsiasi provider come upstream
- Sincronizzazione con qualsiasi dispositivo
- Scopri di più
- Risoluzione dei problemi
- Confronto
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
.gitignoreper 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 diffmostra 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/syncmantiene i segreti decifrati su disco. - Ciclo di pulizia intelligente:
ctg run(scorciatoiactgx) ectg editdecifrano 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 --cleanectg edit --cleangarantiscono che i file decifrati vengano rimossi dal disco anche se erano presenti in precedenza. - Flusso di lavoro con iniezione nell'ambiente:
ctg envinietta i segreti decifrati come variabili d'ambiente per eseguire un comando, senza scriverli affatto su disco. - Piping sicuro dei segreti:
ctg catdecifra in memoria e stampa su stdout per il piping diretto via stdin verso altri strumenti.ctg teecifra lo stdin in PATH senza scrivere testo in chiaro su disco.ctg rotatericifra i segreti esistenti per i destinatari correnti, anch'esso senza scrivere testo in chiaro su disco. - Pulizia:
ctg cleanelimina 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 inittrasforma 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/pushcomegit 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.
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.
