وكيل البرمجة مفتوح المصدر الذي يعمل مع أي نموذج.

يقرأ Codewhale مشروعك ويعدّل الملفات ويشغّل الأوامر ويتحقق من عمله بنفسه — في طرفيتك، باستخدام نموذج مستضاف أو محلي تختاره.

الموقع · التوثيق · سجل التغييرات · المساهمة

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · Català

_{لقطة حقيقية للطرفية من تثبيت جديد — دون مخرجات مُعدّة مسبقًا.}

التثبيت

macOS وLinux:

curl -fsSL https://codewhale.net/install.sh | sh

ينزّل المثبّت ملفات ثنائية متحقَّقًا من مجموع اختبارها إلى ~/.local/bin. إذا ظهرت بعد ذلك رسالة "command not found" عند تشغيل codewhale، فشغّل سطر PATH الواحد الذي يطبعه المثبّت، أو راجع إضافته إلى PATH. يمكنك الترقية في أي وقت بالأمر codewhale update.

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # build from crates.io

البدء السريع

1. افتح مشروعك. شغّل codewhale في المجلد الذي تريد العمل عليه.
2. اربط نموذجًا. شغّل /provider (أو اضغط F3) لإضافة مفتاح مستضاف أو اختيار بيئة تشغيل محلية. إذا كان Ollama يعمل بالفعل مع نموذج محادثة، ينتقل Codewhale إليه من تلقاء نفسه. استخدم /model لتغيير النموذج.
3. أعطه مهمة محددة.

Fix the failing tests and explain what changed.

تعمل المهمة نفسها دون واجهة من سكربت أو من مهمة CI:

codewhale exec "fix the failing tests and explain what changed"

شغّل /help لعرض الأوامر واختصارات لوحة المفاتيح.

طرق التشغيل

يتعامل كل عميل مع Codewhale Runtime المحلي نفسه، لذا تتصرف الجلسات والأدوات والأذونات بالطريقة نفسها في كل مكان.

يجري تطوير تطبيق سطح مكتب أصلي (GPUI) ليكون عميل المنتج المسجَّل الدخول؛ راجع صفحة المنتج لمعرفة حالة الإتاحة. ويتصل امتداد VS Code الذي يصونه المجتمع بـ Runtime نفسه من شريط جانبي (المصدر).

ما الذي يفعله

• أي نموذج دون ارتهان. أكثر من 40 مسار مزوّد مدمجًا — Anthropic وDeepSeek وGoogle وMistral وMoonshot وOpenAI وOpenRouter وxAI وغيرها — إضافة إلى أي نقطة نهاية متوافقة مع OpenAI ونماذج محلية عبر Ollama أو vLLM أو SGLang. المزوّدون
• تبقى السيطرة بيدك. يستكشف وضع Plan دون تغيير أي شيء؛ ويُجري Work وOperate تغييرات. تحدد أوضاع الموافقة متى يحتاج استدعاء الأداة إلى موافقتك، ويستعيد /undo و/restore تغييرات مساحة العمل، ويسرد /receipts كل ملف وأمر وموافقة في الجلسة. الأوضاع · الإيصالات
• مصمَّم للأعمال الطويلة. حدّد /goal دائمًا، وفوّض الأعمال المحدودة إلى الوكلاء الفرعيين، وشغّل فرق وكلاء خاضعة للإشراف مع فحص قبل الإنفاق، أو اكتبها كسكربتات في سير عمل مضمَّنة في المستودع.
• وسّع ما تستخدمه أصلًا. اربط خوادم MCP، وثبّت المهارات والإضافات، وشغّل الخطافات عند أحداث الجلسة والأدوات، وحمّل إضافات Claude Code الموجودة.
• Computer Use. تضيف إضافة مضمَّنة أدوات لمراقبة التطبيقات الأخرى وتشغيلها. راجع صلاحيات وصولها وفعّلها قبل الاستخدام. الدليل

الأوضاع والأذونات

يلتزم Full Access أيضًا بحدود السياسة الصارمة. يشرح دليل الأوضاع والأذونات كل خيار.

الأمان

يعمل Codewhale على جهازك بالصلاحيات التي تمنحها له. تحدّ أوضاع الموافقة وقواعد المستودع مما يجوز للوكيل فعله، وتعمل الأوامر داخل صندوق حماية لنظام التشغيل حيثما كان مدعومًا (Seatbelt على macOS؛ وbubblewrap على Linux اختياري). يعرض /preview-request الطلب المحجوب بياناته الحساسة (redacted) كما هو تمامًا قبل إرسال أي شيء. تبقى أسعار النماذج غير المعروفة غير معروفة بدل أن تُعرض على أنها مجانية.

راجع ترتيب التفويض وصندوق الحماية والقياس عن بُعد — أعداد الاستخدام مفعّلة افتراضيًا، ويوقفها الأمر codewhale config set telemetry false.

التوثيق

المجتمع

نرحّب ببلاغات الأخطاء وأفكار الميزات وطلبات pull request — سواء كنت تستخدم Codewhale منذ أشهر أو تجربه للمرة الأولى. إذا كان هناك مزوّد مفقود أو سير عمل غير مريح، فـافتح issue أو أرسل pull request. المساهمات الأولى مرحَّب بها، ويحتفظ المساهمون بفضل العمل الذي يُقبل. وبنية المستودع مكان جيد للبدء.

انضم إلى Discord، أو أضف Hunter على WeChat (hunterbown) واطلب الانضمام إلى مجموعة Whale Brothers.

التاريخ والترخيص

بدأ Codewhale باسم deepseek-tui ولا يزال يقرأ إعدادات ذلك المشروع وجلساته. وهو الآن محايد تجاه المزوّدين ويُصان باستقلال، وغير تابع لأي مزوّد نماذج. شكرًا لـكل المساهمين ولمجتمعات المصادر المفتوحة التي ساعدت في نموه.

MIT. الأجزاء المقتبسة من مشاريع مفتوحة المصدر أخرى مسجَّلة في إشعارات الأطراف الثالثة.