
cottage v0.7.0
Ein moderner Git-basierter age-verschlüsselter Geheimnisverwalter für Teams.
cottage ist ein GitOps-Tool für Teams zur Verwaltung von age-verschlüsselten Secrets in Git-Repositories.
Es bietet einen einfachen Workflow zum Verschlüsseln/Entschlüsseln von Secrets, zur Verwaltung von Empfängern und um Secrets aus dem Repository herauszuhalten, während eine einfache Weitergabe über VCS weiterhin möglich ist. cottage erzeugt außerdem redigierte Vorschauen verschlüsselter Secrets für bessere Sichtbarkeit und unterstützt sowohl persistente als auch temporäre Entschlüsselungs-Workflows, wobei stets sichergestellt wird, dass Secrets niemals im Klartext committet werden.

- Funktionen
- Installation
- Editor-Integrationen
- KI-Agenten-Integrationen
- Schnellstart
- GitOps
- Git-Hooks
- Pfad-Präfixe
- Zugriffskontrolle
- Jeder Anbieter als Upstream
- Mit jedem Gerät synchronisieren
- Mehr erfahren
- Fehlerbehebung
- Vergleich
Funktionen
- Exposure-sicher: Nutzt Rusts Typsystem, um sicherzustellen, dass Fehler niemals versehentlich Geheimnisse preisgeben können.
- Teamfreundlich: Teile öffentliche Schlüssel (Empfänger) im Repo, halte private Schlüssel (Identitäten) lokal.
- Zugriffskontrolle: Einfache Allow/Deny-Regeln, um zu steuern, welche Geheimnisse für welche Empfänger verschlüsselt werden.
- Verwaltet .gitignore: Aktualisiert
.gitignoreautomatisch, um unverschlüsselte Geheimnisse aus dem Repo herauszuhalten. - Vorschauen: Erzeugt zeitgestempelte, redigierte Vorschauen verschlüsselter Geheimnisse für bessere Sichtbarkeit.
- Aussagekräftige Diffs: Hält git diff sauber & überprüfbar, während
ctg diffden Diff lokal geänderter Geheimnisse mit den verfolgten verschlüsselten Gegenstücken anzeigt. - Prüfsummenverifikation: Verhindert Manipulation durch Verifizierung, dass verschlüsselte Geheimnisse und Empfängerlisten mit den Metadaten übereinstimmen.
- Git-Hooks: Einfaches Einrichten von Git-Hooks, um Geheimnisse vor dem Commit automatisch zu prüfen/verschlüsseln und nach dem Checkout zu entschlüsseln.
- Pfadpräfixe: Optionales Speichern verschlüsselter Geheimnisse und Metadaten in dedizierten Verzeichnissen statt neben den entschlüsselten Dateien.
- Workflow für persistente Geheimnisse:
ctg decrypt/syncbehält entschlüsselte Geheimnisse auf der Festplatte. - Intelligenter Bereinigungs-Lebenszyklus:
ctg run(Kurzformctgx) undctg editentschlüsseln Geheimnisse vor der Operation, behalten sie auf der Festplatte, wenn sie bereits vorher vorhanden waren, oder bereinigen sie danach automatisch, wenn nicht. - Bereinigung bei Abschluss:
ctg encrypt --clean,ctg run --cleanundctg edit --cleanstellen sicher, dass entschlüsselte Dateien von der Festplatte bereinigt werden, selbst wenn sie vorher vorhanden waren. - Workflow zur Umgebungsinjektion:
ctg envinjiziert entschlüsselte Geheimnisse als Umgebungsvariablen, um einen Befehl auszuführen, ohne sie überhaupt auf die Festplatte zu schreiben. - Sichere Geheimnis-Weiterleitung:
ctg catentschlüsselt im Speicher und gibt auf stdout aus, um direkt per stdin an andere Tools weiterzuleiten.ctg teeverschlüsselt stdin in PATH, ohne Klartext auf die Festplatte zu schreiben.ctg rotateverschlüsselt bestehende Geheimnisse für die aktuellen Empfänger neu, ebenfalls ohne Klartext auf die Festplatte zu schreiben. - Aufräumen:
ctg cleanlöscht alle entschlüsselten Geheimnisse aus dem lokalen Repo, damit du deine KI-Agenten mit etwas weniger Sorgen laufen lassen kannst. - Unterstützt jj und Nicht-Git-Verzeichnisse:
ctg initverwandelt jedes Verzeichnis in einen Geheimnisspeicher. - Synchronisierung mit jedem Anbieter: Ermöglicht die Konfiguration jedes Anbieters mit einer API als Upstream und die Nutzung von
ctg pull/diff/pushwiegit pull/diff/push. - Synchronisierung mit jedem Gerät: Mit cottage verschlüsselte und in einem Git-Repo verwaltete Geheimnisse können mit Cottage Sync geräteübergreifend synchronisiert werden.
Installation
Lade die Binärdatei direkt herunter
Oder installiere aus einer Paketregistrierung:
# 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
Auch als Docker-Images verfügbar:
# Docker
docker run --rm -v $PWD:/app sayanarijit/cottage --version
# Podman
podman run --rm -v $PWD:/app quay.io/sayanarijit/cottage --version
Oder lade die neueste Version von GitHub herunter.
Editor-Integrationen
VS Code-Erweiterung
Verwende die Cottage VS Code-Erweiterung, um ctg zu installieren, Copilot-Sicherheits-Hooks hinzuzufügen, Dateien aus dem Explorer zu verschlüsseln und .cott.age-Dateien über den Editor-Workflow zu öffnen.
Installiere sie aus dem Visual Studio Marketplace oder baue und installiere sie lokal aus vscode-plugin-cottage.
