Codg

نظام Harness وكلاء ذكاء اصطناعي للجيل القادم، سهل الاستخدام للبرمجة والعمل: تلقائي وغير متزامن، بتزامن عالٍ وأداء مرتفع، وبكفاءة ودقة عاليتين.

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Русский | العربية

التثبيت

ماك ولينكس:

# Homebrew
brew install vcaesar/tap/codg

# NPM
# npm install -g @vcaesar/codg

ويندوز (PowerShell):

# Winget
# winget install vcaesar.codg

# YOLO (مثبّت PowerShell الأصلي)
irm https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.ps1 | iex

الكل (macOS أو Linux أو Windows عبر Git Bash / MSYS2 / Cygwin / WSL):

# YOLO
curl -fsSL https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.sh | bash

أو انقر مباشرةً على الإصدارات لتنزيله وتشغيله.

انتقل إلى مجلد مشروعك ثم شغّل codg، واستخدم "/init" لتهيئة المشروع. استخدم "/yolo" للتبديل بين الوضع التلقائي ووضع التأكيد، ويمكن ضبط الأذونات من خلال codg.toml.

الميزات

• نظام وكلاء تلقائي وغير متزامن، عالي التزامن والأداء، مع استهلاك منخفض للذاكرة
• دعم مزودي نماذج متعددين (أكثر من 40 مزود API و Pro، و Custom URL API) ونماذج محلية عبر openai-compat أو claude-compat، مع دعم نماذج Openrouter و Ollama و Nvidia وغيرها المجانية، استخدمها عبر "/connect" أو "/models" أو "codg auth"
• قواعد غير متزامنة وقواعد نموذج للوكلاء المتعددين
• ضغط المدخلات والمخرجات والسياق والمطالبات لتوفير الرموز (tokens)؛ التخزين المؤقت والقواعد لتقليل التكلفة
• دعم أي طرفية ونظام تشغيل، بالإضافة إلى دعم طرفيات الويب
• سهل الاستخدام: واجهة TUI متاحة في كل مكان وقريبة من GUI؛ إصدار سطح المكتب والويب في مرحلة BETA
• انقر أو استخدم "/xxx" لتبديل الجلسات، كل شيء في TUI قابل للنقر
• انقر على "Modified Files" أو استخدم "/diff" و"/diff git" لعرض ملفات الفرق داخل TUI كما في VSCode
• إكمال تلقائي للحروف الإنجليزية والعبارات القصيرة
• نظام Agents وSkills وMCP أسهل في الاستخدام، مع دعم Agents وSkills المخصصة
• دعم القنوات والميزات على غرار OpenClaw
• دعم واجهة ويب كاملة و TUI عن بُعد
• دعم إضافات Claude Code/Codex

تطبيق سطح المكتب (BETA)، بعض الميزات لا تزال بحاجة إلى اختبار وإصلاح للأخطاء ثم إصدارها.

المزودون

Atom، Copilot، Anthropic، Anthropic API، OpenAI، OpenAI API، Gemini، Gemini API، OpenRouter، Antigravity، Cursor، Kiro، xAI، Azure، Bedrock، Vertex AI، Nvidia، HuggingFace، Vercel، Ollama Cloud، Cloudflare Workers، GitHub، Poe، Meta، Groq، IO.net، OpenCode Zen، OpenCode Go، Windsurf، Cerebras.

الصين: Z.ai، Zhipu، Zhipu Coding، Kimi، Kimi Coding، DeepSeek، MiniMax، MiniMax China، Qwen، MiMo، Qiniu Cloud، Ali Coding، Ali Coding CN، Tencent Coding.

المعيار

استخدام الذاكرة (RAM)

الأداة	جلسة نشطة واحدة	10 جلسات نشطة	PSS إضافي لكل جلسة مضافة
Codg	65 MB	165 MB	~10 MB
Codex CLI	140.0 MB	334.8 MB	~21.6 MB
Cursor Agent	214.9 MB	1632.4 MB	~157.5 MB
GitHub Copilot CLI	333.3 MB	1756.5 MB	~158.1 MB
OpenCode	371.5 MB	3237.2 MB	~318.4 MB
Claude Code	386.6 MB	2300.6 MB	~212.7 MB

الإبلاغ عن الأخطاء:

افتح Github Issue

كيف نستخدم بياناتك:

حاليًا لا يتم جمع أي بيانات أو قياسات، كما يتم دعم النماذج المحلية بنسبة 100%. عند استخدام واجهة API، يرجى مراجعة سياسات المزوّد المعني.

للاطلاع على استخدام واجهة TUI، راجع توثيق أوامر TUI، واكتب /help داخل TUI لعرض اختصارات المفاتيح والمساعدة الأخرى.

أوامر CLI

الاستخدام: codg -h

codg auth/login               # المصادقة (Atom، OpenAI، GitHub...)
codg web                      # تشغيل واجهة الويب على المنفذ 4096
codg desktop                  # تشغيل تطبيق سطح المكتب (Wails)
codg claw                     # تشغيل وكيل المراسلة (Telegram/Discord/Slack)
codg gateway --private-only   # تشغيل بوابة مؤمّنة
codg models claude            # عرض النماذج المطابقة لـ "claude"
codg runm start Qwen/Qwen3-8B-GGUF   # تشغيل نموذج محلي
codg runm download user/model # تنزيل نموذج GGUF
codg plugin install repo/name # تثبيت مكوّن إضافي
codg plugin list              # عرض المكوّنات المثبّتة
codg install repo/name        # اختصار لـ plugin install
codg mcp add myserver cmd     # إضافة خادم MCP
codg mcp list                 # عرض خوادم MCP المكوّنة
codg skill url add <url>      # إضافة رابط مصدر المهارات
codg themes set catppuccin    # تبديل السمة
# codg logs -f                # متابعة سجلات التطبيق
codg toml                     # عرض الإعدادات بالكامل
codg stats/s                  # عرض إحصائيات الاستخدام
codg dirs                     # طباعة مسارات البيانات/الإعدادات
codg projects                 # عرض مجلدات المشاريع المتتبَّعة
codg lite 2                   # تعيين مستوى الوضع الخفيف (0-4)
codg merge origin main        # دمج git آمن مع نسخة احتياطية v1/
codg migrate                  # ترحيل الإعدادات من .claude/.opencode
codg vm build                 # البناء على جهاز افتراضي بعيد
codg vm run -- make test      # تنفيذ أمر على الـ VM
codg sandbox run -- ./test.sh # التشغيل في بيئة الحماية
codg sandbox status           # التحقق من توفر الـ sandbox
codg used                          # عرض حدود الاستخدام وإحصائيات API لجميع المزوّدين
codg update                   # تحديث إصدار codg
codg updatep                  # تحديث تعريفات المزوّدين

إضافة Claude-Code/Codex

# Codg
codg plugin marketplace add earthtojake/text-to-cad
codg plugin add cad@text-to-cad

أمثلة الاستخدام

الوضع غير التفاعلي (codg run)

# تمرير المدخلات من أمر آخر.
cat errors.log | codg run "ما سبب هذه الأخطاء؟"
# الوضع المفصّل (إخراج التصحيح إلى stderr).
codg run -v "تصحيح هذه الدالة"

واجهة الويب

# تشغيل واجهة الويب على المنفذ الافتراضي 4096.
codg web
# منفذ مخصص.
codg web -p 8080

# وضع API فقط (بدون واجهة أمامية أو متصفح).
codg web 0, codg api

إدارة المكوّنات الإضافية

# تثبيت مكوّن إضافي من مستودع Git.
codg install github.com/user/codg-xxx-auth

الوكلاء والمهارات المخصصة:

انسخ xx_agent.md (.codg/agents/templates) أو SKILL.md (.codg/skills) إلى المجلد المناسب

نظام الإعدادات

أنشئ ملف codg.toml في جذر المشروع (أو ~/.codg/config/codg.toml للإعدادات العامة):

# codg.toml — إعداد الحد الأدنى للمشروع.
[options]
lite_mode = 2          # 0 = جميع الوكلاء، 2 = المجموعة الافتراضية المبسطة، 4 = وكيل واحد
locale    = "en"       # لغة الواجهة: en، zh-CN، ja
ctx_resize = true
token_save = 2

[options.tui]
theme     = "catppuccin"
dark_mode = true
compact_mode = false

[tools.grep]
backends = ["rg", "sg", "csearch", "ngram", "regex"]

إعداد المزوّد

# استخدام مفتاح API (يدعم توسعة $ENV_VAR).
[providers.anthropic]
api_key = "$ANTHROPIC_API_KEY"

# استخدام OAuth (يُضبط عبر `codg auth`).
[providers.openai]
oauth = true

# مزوّد مخصّص / مستضاف ذاتياً.
[providers.local]
name     = "My Local LLM"
type     = "openai-compat"
base_url = "http://localhost:8080/v1"
api_key  = "not-needed"

تخصيص الوكلاء

# الصيغة المختصرة: تعيين نوع النموذج.
agents.coder = "large"
agents.task  = "small"

# الصيغة الكاملة: ضبط الوكيل بدقة.
[agents.advisor]
model           = "large"
temperature     = 0.3
thinking_budget = 32000

خوادم MCP

# خادم MCP عبر HTTP.
[mcp.websearch]
type = "http"
url  = "https://mcp.exa.ai/mcp?tools=web_search_exa"

المهارات

# التحميل والتنزيل التلقائي في TUI أو عبر codg skill
[option]
skill_urls = ["https://github.com/user/skills"]

النماذج المحلية (llama.cpp)

[llama]
port     = 8090
host     = "127.0.0.1"
ctx_size = 32000
gpu      = "auto"          # auto، cuda، off

قنوات المراسلة

[channels.telegram]
enabled     = true
token       = "$TELEGRAM_BOT_TOKEN"
allowed_ids = ["123456789"]

[channels.discord]
enabled  = true
token    = "$DISCORD_BOT_TOKEN"

الصلاحيات

[permissions]
allowed_tools = ["bash", "edit", "view", "glob", "grep"]
allowed_dirs = ["**x"] # جميع المجلدات