cottage

cottage टीमों के लिए एक GitOps टूल है जो git रिपॉज़िटरी में age-encrypted secrets को प्रबंधित करता है।

यह secrets को encrypt/decrypt करने, recipients को प्रबंधित करने, और secrets को रिपॉज़िटरी से बाहर रखने के लिए एक सरल workflow प्रदान करता है, साथ ही VCS के माध्यम से आसान शेयरिंग की सुविधा देता है। cottage बेहतर visibility के लिए encrypted secrets के redacted previews भी generate करता है और persistent तथा temporary decryption workflows दोनों का समर्थन करता है, जबकि यह सुनिश्चित करता है कि secrets कभी plaintext में commit न हों।

1. Features
2. Installation
3. Editor Integrations
   1. VS Code Extension
   2. Cursor and Eclipse Extension
   3. Vim Plugin
4. AI Agent Integrations
   1. Claude Code Integration
   2. GitHub Copilot Integration
   3. Codex Integration
   4. Antigravity (agy) Integration
   5. Cursor Integration
5. Quick Start
6. GitOps
7. Git Hooks
8. Access Control
   1. Rules
   2. Verification
9. Any Provider as Upstream
   1. Example plugins
10. Sync with any device
11. Learn More
12. Troubleshooting
13. Comparison
    1. age vs Other Encryption
    2. cottage vs SOPS
    3. cottage vs dotenvx
    4. cottage vs agebox

Features

• Exposure-safe: Rust के type system का उपयोग करता है ताकि bugs कभी गलती से secrets को expose न कर सकें।
• Team-friendly: रिपॉज़िटरी में public keys (recipients) साझा करें, private keys (identities) local रखें।
• Access Control: सरल allow/deny नियम यह नियंत्रित करने के लिए कि कौन से secrets किन recipients के लिए encrypt किए जाएँ।
• Manages .gitignore: unencrypted secrets को रिपॉज़िटरी से बाहर रखने के लिए .gitignore को स्वचालित रूप से अपडेट करता है।
• Previews: बेहतर visibility के लिए encrypted secrets के timestamped redacted previews generate करता है।
• Rich diffs: git diff को साफ़ और reviewable रखता है, जबकि ctg diff locally modified secrets का tracked encrypted counterparts के साथ diff दिखाता है।
• Checksum verification: यह सत्यापित करके tampering रोकता है कि encrypted secrets और recipient lists metadata से मेल खाते हैं।
• Git hooks: commit से पहले secrets को स्वचालित रूप से check/encrypt करने और checkout के बाद decrypt करने के लिए git hooks आसानी से सेट करें।
• Persistent secrets workflow: ctg decrypt/sync decrypted secrets को disk पर रखता है।
• Smart cleanup lifecycle: ctg run (shortcut ctgx) और ctg edit operation से पहले secrets decrypt करते हैं, यदि वे पहले से मौजूद थे तो उन्हें disk पर रखते हैं या यदि नहीं थे तो बाद में स्वचालित रूप से साफ़ कर देते हैं।
• Clean on completion: ctg encrypt --clean, ctg run --clean, और ctg edit --clean यह सुनिश्चित करते हैं कि decrypted files disk से साफ़ हो जाएँ, भले ही वे पहले मौजूद थीं।
• Environment injection workflow: ctg env decrypted secrets को environment variables के रूप में inject करके command चलाता है, बिना उन्हें disk पर लिखे।
• Secure secret piping: ctg cat PATH memory में decrypt करता है और stdout पर print करता है ताकि सीधे अन्य tools को stdin piping की जा सके।
• Clean up: ctg clean local repo से सभी decrypted secrets हटा देता है ताकि आप अपने AI agents को थोड़ी कम चिंता के साथ चला सकें।
• Supports jj and non-git directories: ctg init किसी भी directory को secret store में बदल देता है।
• Sync with any provider: आप किसी भी API वाले provider को upstream के रूप में configure कर सकते हैं, और git pull/diff/push की तरह ctg pull/diff/push का उपयोग शुरू कर सकते हैं।
• Sync with any device: cottage से encrypted और git repo में प्रबंधित secrets को Cottage Sync के साथ devices के बीच sync किया जा सकता है।

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

Docker images के रूप में भी उपलब्ध है:

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

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

या GitHub से नवीनतम release डाउनलोड करें।

Editor Integrations

VS Code Extension

ctg install करने, Copilot safety hooks जोड़ने, Explorer से files encrypt करने, और editor workflow के माध्यम से .cott.age files खोलने के लिए Cottage VS Code extension का उपयोग करें।

इसे Visual Studio Marketplace से install करें, या vscode-plugin-cottage से locally build और install करें।

Cursor and Eclipse Extension

VSX file डाउनलोड करें और इसे अपने Cursor या Eclipse IDE में install करें। यह VS Code extension की तरह ही काम करता है।

Vim Plugin

Vim या Neovim से secrets को encrypt/decrypt करने के लिए cottage.vim plugin का उपयोग करें।

AI Agent Integrations

नीचे दिए गए सभी integrations AI agents को सीधे ctg/ctgx चलाने और secret files को देखने या edit करने से रोकते हैं: .cottage/ के अंदर कुछ भी, कोई भी *.cott.* file (encrypted *.cott.age blobs और redacted *.cott.toml previews), और कोई भी decrypted file जिसका disk पर अभी भी *.cott.age counterpart मौजूद है।

Claude Code Integration