cottage v0.7.0

cottage ist ein GitOps-Tool für Teams, um age-verschlüsselte Secrets in Git-Repositories zu verwalten.

Es bietet einen einfachen Workflow zum Ver- und Entschlüsseln von Secrets, zur Verwaltung von Empfängern und hält Secrets aus dem Repository heraus, während sie dennoch einfach über VCS geteilt werden können. cottage erzeugt außerdem geschwärzte Vorschauen verschlüsselter Secrets für bessere Sichtbarkeit und unterstützt sowohl persistente als auch temporäre Entschlüsselungs-Workflows, wobei sichergestellt wird, dass Secrets niemals im Klartext committet werden.

1. Funktionen
2. Installation
3. Editor-Integrationen
   1. VS Code-Erweiterung
   2. Cursor- und Eclipse-Erweiterung
   3. Vim-Plugin
4. KI-Agenten-Integrationen
   1. Claude Code-Integration
   2. GitHub Copilot-Integration
   3. Codex-Integration
   4. Antigravity (agy)-Integration
   5. Cursor-Integration
5. Schnellstart
6. GitOps
7. Git-Hooks
8. Zugriffskontrolle
   1. Regeln
   2. Verifizierung
9. Jeder Anbieter als Upstream
   1. Beispiel-Plugins
10. Mit jedem Gerät synchronisieren
11. Mehr erfahren
12. Fehlerbehebung
13. Vergleich
    1. age vs. andere Verschlüsselung
    2. cottage vs. SOPS
    3. cottage vs. dotenvx
    4. cottage vs. agebox

Funktionen

• Sicher vor Offenlegung: Nutzt Rusts Typsystem, um sicherzustellen, dass Fehler niemals versehentlich Secrets offenlegen können.
• Teamfreundlich: Teile öffentliche Schlüssel (Empfänger) im Repository, halte private Schlüssel (Identitäten) lokal.
• Zugriffskontrolle: Einfache Allow/Deny-Regeln, um zu steuern, welche Secrets für welche Empfänger verschlüsselt werden.
• Verwaltet .gitignore: Aktualisiert .gitignore automatisch, um unverschlüsselte Secrets aus dem Repository herauszuhalten.
• Vorschauen: Erzeugt mit Zeitstempel versehene geschwärzte Vorschauen verschlüsselter Secrets für bessere Sichtbarkeit.
• Aussagekräftige Diffs: Hält Git-Diffs sauber und überprüfbar, während ctg diff den Diff lokal geänderter Secrets mit den getrackten verschlüsselten Gegenstücken anzeigt.
• Checksummen-Verifizierung: Verhindert Manipulation, indem überprüft wird, dass verschlüsselte Secrets und Empfängerlisten mit den Metadaten übereinstimmen.
• Git-Hooks: Einfaches Einrichten von Git-Hooks, um Secrets vor dem Commit automatisch zu prüfen/verschlüsseln und nach dem Checkout zu entschlüsseln.
• Persistenter Secrets-Workflow: ctg decrypt/sync behält entschlüsselte Secrets auf der Festplatte.
• Intelligenter Aufräum-Lebenszyklus: ctg run (Kurzform ctgx) und ctg edit entschlüsseln Secrets vor der Operation und behalten sie auf der Festplatte, wenn sie bereits vorher vorhanden waren, oder räumen sie danach automatisch auf, wenn sie es nicht waren.
• Sauber nach Abschluss: ctg encrypt --clean, ctg run --clean und ctg edit --clean stellen sicher, dass entschlüsselte Dateien von der Festplatte entfernt werden, selbst wenn sie vorher vorhanden waren.
• Umgebungsinjektions-Workflow: ctg env injiziert entschlüsselte Secrets als Umgebungsvariablen, um einen Befehl auszuführen, ohne sie überhaupt auf die Festplatte zu schreiben.
• Sicheres Secret-Piping: ctg cat PATH entschlüsselt im Speicher und gibt auf stdout aus, um direkt per stdin an andere Tools weitergeleitet zu werden.
• Aufräumen: ctg clean löscht alle entschlüsselten Secrets aus dem lokalen Repository, damit du deine KI-Agenten mit etwas weniger Sorgen laufen lassen kannst.
• Unterstützt jj und Nicht-Git-Verzeichnisse: ctg init verwandelt jedes Verzeichnis in einen Secret-Store.
• Mit jedem Anbieter synchronisieren: Ermöglicht dir, jeden Anbieter mit einer API als Upstream zu konfigurieren und ctg pull/diff/push wie git pull/diff/push zu verwenden.
• Mit jedem Gerät synchronisieren: Mit cottage verschlüsselte und in einem Git-Repository verwaltete Secrets können mit Cottage Sync geräteübergreifend synchronisiert werden.

Installation

# 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.

Cursor- und Eclipse-Erweiterung

Lade die VSX-Datei herunter und installiere sie in deiner Cursor- oder Eclipse-IDE. Sie funktioniert ähnlich wie die VS Code-Erweiterung.

Vim-Plugin

Verwende das cottage.vim-Plugin, um Secrets aus Vim oder Neovim zu ver- und entschlüsseln.

KI-Agenten-Integrationen