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

- الميزات
- التثبيت
- تكاملات المحررات
- تكاملات وكلاء الذكاء الاصطناعي
- البدء السريع
- GitOps
- خطافات Git
- بادئات المسارات
- التحكم في الوصول
- أي مزوّد كمنبع أعلى
- المزامنة مع أي جهاز
- معرفة المزيد
- استكشاف الأخطاء وإصلاحها
- المقارنة
الميزات
- آمن ضد الكشف: يستخدم نظام الأنواع في Rust لضمان عدم تسبب الأخطاء في كشف الأسرار عن طريق الخطأ.
- ملائم للفريق: شارك المفاتيح العامة (المستلمين) في المستودع، واحتفظ بالمفاتيح الخاصة (الهويات) محليًا.
- التحكم في الوصول: قواعد سماح/رفض بسيطة للتحكم في الأسرار التي تُشفَّر ولمن.
- يدير .gitignore: يحدّث
.gitignoreتلقائيًا لإبقاء الأسرار غير المشفرة خارج المستودع. - معاينات: يولّد معاينات مؤقتة الطابع ومنقّحة للأسرار المشفرة لتحسين الرؤية.
- فروقات غنية: يحافظ على نظافة
git diffوقابليته للمراجعة، بينما يعرضctg diffفروقات الأسرار المعدّلة محليًا مع نظيراتها المشفرة المتتبَّعة. - التحقق من المجموع الاختباري: يمنع التلاعب بالتحقق من تطابق الأسرار المشفرة وقوائم المستلمين مع البيانات الوصفية.
- خطافات Git: إعداد خطافات git بسهولة للتحقق من الأسرار/تشفيرها تلقائيًا قبل الالتزام وفك تشفيرها بعد السحب.
- بادئات المسارات: تخزين الأسرار المشفرة والبيانات الوصفية اختياريًا تحت أدلة مخصصة، بدلًا من جوار الملفات المفكوكة التشفير.
- سير عمل الأسرار الدائمة: يُبقي
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جميع الأسرار المفكوكة التشفير من المستودع المحلي ليتيح لك تشغيل وكلاء الذكاء الاصطناعي بقلق أقل قليلًا. - يدعم jj والأدلة غير التابعة لـ git: يحوّل
ctg initأي دليل إلى مخزن أسرار. - المزامنة مع أي مزوّد: يتيح لك تهيئة أي مزوّد لديه API كمنبع أعلى، والبدء في استخدام
ctg pull/diff/pushمثلgit pull/diff/push. - المزامنة مع أي جهاز: يمكن مزامنة الأسرار المشفرة بـ cottage والمدارة في مستودع git عبر الأجهزة باستخدام Cottage Sync.
التثبيت
أو ثبّت من سجل حزم:
# 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.
تكاملات المحررات
إضافة VS Code
استخدم إضافة Cottage لـ VS Code لتثبيت ctg، وإضافة خطافات أمان Copilot، وتشفير الملفات من Explorer، وفتح ملفات .cott.age عبر سير عمل المحرر.
ثبّتها من Visual Studio Marketplace، أو ابنِها وثبّتها محليًا من vscode-plugin-cottage.
إضافة Cursor وEclipse
نزّل ملف VSX وثبّته في Cursor أو Eclipse IDE. تعمل بشكل مشابه لإضافة VS Code.
إضافة Vim
استخدم إضافة cottage.vim لتشفير/فك تشفير الأسرار من Vim أو Neovim.
تكاملات وكلاء الذكاء الاصطناعي
جميع التكاملات أدناه تمنع وكلاء الذكاء الاصطناعي من تشغيل ctg/ctgx مباشرةً ومن عرض أو تعديل الملفات السرية: أي شيء داخل .cottage/، وأي ملف *.cott.* (كتل *.cott.age المشفرة ومعاينات *.cott.toml المنقّحة)، وأي ملف مفكوك التشفير لا يزال له نظير *.cott.age على القرص.
- .agents لـ Antigravity (
agy) - .claude لـ Claude Code
- .codex لـ Codex
- .cursor لـ Cursor
- .github لـ GitHub Copilot
البدء السريع
تهيئة المشروع:
mkdir project && cd project
