
مدير أسرار حديث قائم على git ومشفر باستخدام age للفرق.
cottage هي أداة GitOps تتيح للفرق إدارة الأسرار المشفّرة بـ age داخل مستودعات git.
توفّر سير عمل بسيطًا لتشفير/فك تشفير الأسرار، وإدارة المستلمين، وإبقاء الأسرار خارج المستودع مع السماح بمشاركتها بسهولة عبر أنظمة التحكم بالإصدارات (VCS). كما تُنشئ cottage معاينات محجوبة للأسرار المشفّرة لتحسين الرؤية، وتدعم سير عمل فك التشفير الدائم والمؤقت على حد سواء، مع ضمان عدم إيداع الأسرار أبدًا بنص صريح.

.gitignore تلقائيًا لإبقاء الأسرار غير المشفرة خارج المستودع.git diff وقابليته للمراجعة، بينما يعرض ctg diff فروقات الأسرار المعدّلة محليًا مع نظيراتها المشفرة المتتبَّعة.ctg decrypt/sync الأسرار المفكوكة التشفير على القرص.ctg run (الاختصار ctgx) وctg edit تشفير الأسرار قبل العملية، ويُبقيها على القرص إن كانت موجودة مسبقًا أو ينظّفها تلقائيًا بعد ذلك إن لم تكن كذلك.ctg encrypt --clean وctg run --clean وctg edit --clean تنظيف الملفات المفكوكة التشفير من القرص حتى لو كانت موجودة مسبقًا.ctg env الأسرار المفكوكة التشفير كمتغيرات بيئة لتشغيل أمر، دون كتابتها على القرص إطلاقًا.ctg cat التشفير في الذاكرة ويطبع إلى stdout للتمرير المباشر عبر stdin إلى أدوات أخرى. ويشفّر ctg tee مدخلات stdin إلى PATH دون كتابة نص صريح على القرص. ويعيد ctg rotate تشفير الأسرار الموجودة للمستلمين الحاليين، أيضًا دون كتابة نص صريح على القرص.ctg clean جميع الأسرار المفكوكة التشفير من المستودع المحلي ليتيح لك تشغيل وكلاء الذكاء الاصطناعي بقلق أقل قليلًا.ctg init أي دليل إلى مخزن أسرار.ctg pull/diff/push مثل git pull/diff/push.أو ثبّت من سجل حزم:
# 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:
# Docker
docker run --rm -v $PWD:/app sayanarijit/cottage --version
# Podman
podman run --rm -v $PWD:/app quay.io/sayanarijit/cottage --version
أو نزّل أحدث إصدار من GitHub.
استخدم إضافة Cottage لـ VS Code لتثبيت ctg، وإضافة خطافات أمان Copilot، وتشفير الملفات من Explorer، وفتح ملفات .cott.age عبر سير عمل المحرر.
ثبّتها من Visual Studio Marketplace، أو ابنِها وثبّتها محليًا من vscode-plugin-cottage.
نزّل ملف VSX وثبّته في Cursor أو Eclipse IDE. تعمل بشكل مشابه لإضافة VS Code.
استخدم إضافة cottage.vim لتشفير/فك تشفير الأسرار من Vim أو Neovim.
جميع التكاملات أدناه تمنع وكلاء الذكاء الاصطناعي من تشغيل ctg/ctgx مباشرةً ومن عرض أو تعديل الملفات السرية: أي شيء داخل .cottage/، وأي ملف *.cott.* (كتل *.cott.age المشفرة ومعاينات *.cott.toml المنقّحة)، وأي ملف مفكوك التشفير لا يزال له نظير *.cott.age على القرص.
agy)تهيئة المشروع:
mkdir project && cd project