cottage v0.7.0

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

यह secrets को encrypt/decrypt करने, recipients को प्रबंधित करने, और secrets को रेपो से बाहर रखने के लिए एक सरल workflow प्रदान करता है, साथ ही VCS के माध्यम से आसान शेयरिंग की सुविधा देता है। cottage एन्क्रिप्टेड secrets के redacted previews भी जनरेट करता है ताकि बेहतर visibility मिल सके, और 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 के लिए एन्क्रिप्टेड secrets के timestamped redacted previews जनरेट करता है।
• 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 ऑपरेशन से पहले 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 पर pipe किया जा सके।
• 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 से encrypt किए गए और 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 को देखने या संपादित करने से रोकते हैं: .cottage/ के अंदर कुछ भी, कोई भी *.cott.* file (encrypted *.cott.age blobs और redacted *.cott.toml previews), और कोई भी decrypted file जिसका disk पर अभी भी *.cott.age counterpart मौजूद है।

Claude Code Integration