تجاوز إلى المحتوى
مجاني ومفتوح المصدر

التوثيق

ينجز مساعدو الذكاء الاصطناعي مهام البرمجة. يشرح الدليل أدوات سطر الأوامر (CLI)، وقوائم الطرفية (TUI)، وأداة tmux التي تُبقي المهام قيد التشغيل، والاتصال القياسي بين أدوات الذكاء الاصطناعي (MCP).

التثبيت

تحتاج إلى macOS أو Linux أو WSL، وNode 22.12 أو أحدث، وtmux 3.0 أو أحدث، وأداة CLI واحدة على الأقل من أحد المزوّدين، مثبّتة ومسجَّل الدخول فيها.

$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagents
يتحقق reevesagents doctor من ذلك كله. ويجري reevesagents setup الفحوص نفسها في صورة معالج للتشغيل الأول، ومع --attach يربط الـ MCP أيضًا بكل أداة مضيفة مثبّتة.

البداية السريعة

ابدأ فريقًا، وتفقّده، وتدخّل، ثم أوقفه.

ابدأ فريقًا

shell
reevesagents spawn cc:lead codex:api kimi:docs \
  --name "feature x" --prompt "Build feature X. The lead splits the work."

يُكتب كل مساعد بالشكل provider[:nickname[:model]]، والأول هو القائد. استخدم reevesagents add لإضافة مساعدين إلى أحدث تشغيلة.

راقب ووجّه

shell
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open api

يلصق send النص من دون إرساله، فأتبعه بـ key <agent> enter. ويأخذك open إلى المساعد داخل tmux.

أوقف التشغيلة

shell
reevesagents stop "feature x" --yes
تنتظر stop وkill وأوامر delete الخيار --yes (أو ALLOW_DESTRUCTIVE=1).

قائمة الطرفية والمتصفح والأوامر

تتشارك القائمة (TUI) وواجهة المتصفح وأداة سطر الأوامر (CLI) سجلات المهام في ~/.reeves. تُبقي أداة الطرفية tmux المساعدين قيد التشغيل.

  • اكتب reevesagents بلا معطيات لتفتح TUI. تلفّ نفسها في جلسة tmux اسمها reeves، ويعطّل REEVES_NO_TMUX_WRAPPER=1 هذا السلوك.
  • يشغّل reevesagents web واجهة Web UI على 127.0.0.1، على المنفذ 8080 أو أول منفذ حر بعده. ترفض ترويسات Host غير loopback وطلبات الكتابة القادمة من أصل آخر، ويوقفها Ctrl+C من دون أن يمسّ مساعدينك.
  • وكل شيء متاح أيضًا أمرًا في CLI. على السكربتات أن تقرأ --json، لأن المخرجات النصية العادية قد تتغير بين الإصدارات.
  • وفي الأساس يعمل tmux: جلسة لكل تشغيلة ونافذة لكل مساعد. وينقلك reevesagents open <id> إلى النافذة الصحيحة أينما كنت.

التحكم بالوكلاء (MCP)

اربط أداة برمجة بالأدوات الأخرى عبر بروتوكول قياسي (MCP). هذا اختياري. أعد تشغيل الأداة بعد ربطها.

shell
reevesagents attach cc
reevesagents hosts
  • ست أدوات CLI تستطيع استضافته: Claude Code وCodex وKimi Code وQwen Code وHermes وOpenCode. يربطه reevesagents attach بلا اسم بكل الأدوات المثبّتة، ويزيله reevesagents detach <cli> من الأداة التي تسمّيها.
  • تحصل الأداة المضيفة على أدوات بسيطة: إنشاء المساعدين، ولصق النص، وضغط المفاتيح، وقراءة المخرجات، وحسم الموافقات. ومن يكتب التعليمات للمضيف هو من يقرر ما يفعله الفريق.
  • يحصل العمّال المنشأون على الأدوات فقط حين تربط أدواتهم أيضًا. وعند إنشاء المساعدين عبر MCP، يُطبّق max_agents (وقيمته 100 افتراضيًا) حدًّا لعدد المساعدين في التشغيلة الواحدة.

الأوامر

كل أمر فرعي في reevesagents. ومن دون معطيات يفتح TUI.

التشغيلات

spawn [spec...]

يبدأ تشغيلة. تُكتب كل مواصفة بالشكل provider[:nickname[:model]]، والوكيل الأول هو القائد. الخيارات: --name، --cwd، --prompt، --skip، --run، --auth-mode، --effort، --extra-args، --json.

add [spec...]

يضيف وكلاء إلى أحدث تشغيلة نشطة. الخيارات: --run، --prompt، --skip، --auth-mode، --effort، --extra-args، --json. يجب تحديد مواصفة واحدة على الأقل.

runs

يسرد التشغيلات النشطة. --json.

open <id>

ينقلك إلى نافذة تشغيلة أو وكيل في tmux. يقبل معرّفًا أو اسمًا أو اسمًا مستعارًا أو بادئة فريدة.

peek <agent-id>

يعرض المخرجات الأخيرة لوكيل واحد. -n/--lines (القيمة الافتراضية 20)، --json.

stop <run-id>يتطلب --yes

يوقف تشغيلة ويغلق جلسة tmux الخاصة بها. -y/--yes.

kill <agent-id>يتطلب --yes

يوقف وكيلًا واحدًا. تنتهي التشغيلة عند توقف آخر وكيل نشط فيها. -y/--yes.

توجيه مساعد

send <agent-id> <text...>

يلصق النص في حقل إدخال الوكيل من دون إرساله.

key <agent-id> <key>

يرسل مفتاحًا واحدًا مسموحًا به: enter، escape، backspace، tab، space، up، down، left، right، ctrl-c.

interrupt <agent-id>

يرسل ctrl-c.

السجلات والأرشيف

agents [run-id]

يسرد الوكلاء في التشغيلات النشطة أو في تشغيلة محددة. --json.

providers

يسرد المزوّدين وتوفّرهم والنماذج المعروفة. --models، --json.

tools

يسرد أدوات الوكيل مع حالة التثبيت وتسجيل الدخول. --json.

delete <agent-id>يتطلب --yes

يحذف سجل وكيل انتهى عمله. -y/--yes.

delete-run <run-id>يتطلب --yes

يحذف تشغيلة منتهية. -y/--yes.

history

يسرد التشغيلات المؤرشفة. --json.

delete-history <id>يتطلب --yes

يحذف سجلًا واحدًا من الأرشيف. -y/--yes.

الموافقات

approvals

يسرد طلبات الموافقة المعلّقة. --json.

approve <approval-id> [note]

يقبل طلب موافقة معلّقًا.

deny <approval-id> [note]

يرفض طلب موافقة معلّقًا.

مضيفو MCP

hosts

يسرد أدوات CLI المضيفة الداعمة لـ MCP، ويبيّن المربوط منها. --json.

attach [cli]

يربط الـ MCP بأداة CLI مضيفة واحدة أو بكل الأدوات المضيفة المثبّتة، عبر أوامرها أو ملف إعدادها. يعيد --force كتابة تسجيل موجود.

detach <cli>

يزيل الـ MCP من أداة CLI مضيفة عبر أوامرها أو ملف إعدادها.

mcp

يشغّل خادم MCP للتحكم بالوكلاء عبر stdio. تنفّذ أداة CLI المضيفة هذا الأمر.

الإعداد والإعدادات المسبقة

config [key] [value]

يعرض أو يقرأ أو يضبط حقل إعداد قابلًا للتحرير. --json.

presets

يسرد الإعدادات المسبقة المحفوظة. --json.

save-preset <run-id> <name> [description...]

يحفظ تشغيلة نشطة بوصفها إعدادًا مسبقًا.

start-preset <name>

يبدأ تشغيلة من إعداد مسبق. --name، --cwd.

delete-preset <name>يتطلب --yes

يحذف إعدادًا مسبقًا. -y/--yes.

التجهيز والأدوات

setup

يفحص tmux وNode وأدوات CLI المثبّتة عند التشغيل الأول. يربط --attach جميع الأدوات المضيفة المثبّتة. يعرض --json حالة التجهيز.

doctor

يجري فحوصات سلامة البيئة. يعيد رمز خروج غير صفري عند الفشل. --json.

skills [action]

يثبّت مهارة ReevesAgents أو يزيلها أو يفحصها لأدوات CLI الداعمة للمهارات (install، remove، status، والافتراضي status). --json.

reap

يوقف الوكلاء الذين اختفت نوافذهم أو تجاوزوا max_lifetime_ms ويغلق جلسات tmux اليتيمة. --json.

web

يشغّل في المقدمة واجهة Web UI التي تستمع على عنوان loopback وحده. --port، --no-open.

أدوات MCP

الأدوات الـ31 التي تستطيع أداة CLI مربوطة أن تستدعيها، مصنّفة بحسب الغرض.

الإنشاء والتوجيه

spawnمطلوبproviderاختياريrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

ينشئ عاملًا. عند حذف run_id يعيد استخدام تشغيلة جلسة MCP الحالية، التي تُنشأ عند أول استدعاء لـ spawn. عند تحديد run_id يستهدف تشغيلة أخرى.

killمطلوبagent_id

يوقف وكيلًا واحدًا.

stopمطلوبrun_id

يوقف تشغيلة كاملة ويغلق جلسة tmux الخاصة بها.

send_textمطلوبagent_idtext

يلصق النص في حقل إدخال الوكيل من دون إرساله.

send_keyمطلوبagent_idkey

يرسل مفتاحًا واحدًا مسموحًا به مثل enter أو escape أو ctrl-c.

interruptمطلوبagent_id

يرسل ctrl-c إلى وكيل.

readمطلوبagent_idاختياريlines

يقرأ المخرجات الأخيرة لشاشة الوكيل مع إزالة تسلسلات ANSI وحجب البيانات الحساسة. القيمة الافتراضية: 20 سطرًا.

الفحص

list

يسرد التشغيلات والوكلاء.

list_providers

كتالوج المزوّدين والنماذج على هذا الجهاز.

list_tools

كتالوج الأدوات على هذا الجهاز: أدوات CLI مساعدة يمكن للوكيل تشغيلها من صدفته، مع حالة التثبيت وتسجيل الدخول.

list_history

التشغيلات المؤرشفة.

list_presets

الإعدادات المسبقة المحفوظة.

list_hosts

أدوات CLI الداعمة لـ MCP، مع بيان المربوط منها.

get_config

الإعداد العام الحالي.

doctor

فحوصات سلامة البيئة.

الموافقات

request_approvalمطلوبagent_idactionsummaryاختياريdetailsrisk

ينشئ طلب موافقة.

resolve_approvalمطلوبapproval_iddecisionاختياريnote

يقبل طلبًا معلّقًا أو يرفضه.

check_approvalمطلوبapproval_id

يقرأ طلب موافقة واحدًا.

list_approvalsاختياريrun_idstatus

يسرد طلبات الموافقة مع مرشحات اختيارية.

دورة الحياة

deleteمطلوبagent_id

يحذف سجل وكيل انتهى عمله.

delete_runمطلوبrun_id

يحذف تشغيلة منتهية.

delete_historyمطلوبid

يحذف سجلًا واحدًا من الأرشيف.

openمطلوبid

ينقل عميل tmux المتصل إلى تشغيلة أو وكيل.

reap

ينظّف فورًا الوكلاء الذين اختفت نوافذهم أو تجاوزوا العمر المحدد، وجلسات tmux اليتيمة.

الإعداد والإعدادات المسبقة

set_configاختياريpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguage

يضبط حقلًا واحدًا أو أكثر من حقول الإعداد القابلة للتحرير.

save_presetمطلوبrun_idnameاختياريdescription

يحفظ تشغيلة نشطة بوصفها إعدادًا مسبقًا.

start_presetمطلوبnameاختياريrun_nameworking_dir

يبدأ تشغيلة من إعداد مسبق.

delete_presetمطلوبname

يحذف إعدادًا مسبقًا.

المضيفون والمهارات

attach_hostاختياريkey

يربط الـ MCP بأداة CLI مضيفة واحدة أو بكل الأدوات المضيفة المثبّتة.

detach_hostمطلوبkey

يزيل الـ MCP من أداة CLI مضيفة واحدة.

install_skillsاختياريstatus

يثبّت مهارة ReevesAgents لأدوات CLI الداعمة للمهارات أو يعرض مواقعها.

وهناك موردان يحملان كتالوج المزوّدين ودليل الاستخدام: reevesagents://providers, reevesagents://guide

الإعداد

تعيش الإعدادات في ~/.reeves/config.json. غيّر أيًّا منها بالأمر reevesagents config <key> <value> أو من شاشات الإعدادات. ويحوّل reevesagents config language tr الواجهة إلى إحدى لغاتها العشر.

الحقول

peek_interval_ms5000

إعداد محفوظ للفاصل الزمني لتحديث المخرجات. تستخدم الواجهات الحالية فواصل تحديث ثابتة.

peek_lines10

إعداد محفوظ لعدد سطور المخرجات. تستخدم الشاشات الحالية وقراءات CLI/MCP أعداد سطور خاصة بها.

max_agents100

الحد الأقصى للوكلاء النشطين في كل تشغيلة، وتطبّقه أداة spawn في MCP. لا تطبّقه واجهات الإطلاق الأخرى.

max_depth5

إعداد محفوظ لعمق الاستدعاء الذاتي. لا يطبّقه محرك التشغيلات الحالي.

ready_delay_ms5000

مدة انتظار أداة CLI جديدة حتى تصبح جاهزة قبل لصق التعليمات.

max_lifetime_ms0

يوقف الوكلاء الذين تجاوزوا هذه المدة. تعطّل القيمة 0 هذا الحد.

default_permissionsask

وضع الأذونات الافتراضي للوكلاء الجدد: ask أو skip.

languageen

لغة الواجهة، وهي أحد رموز اللغات العشرة المدعومة.

الحالة على القرص

~/.reeves/
  config.json
  presets/<name>.json
  runs/<run-id>/
    run.json
    agents/<agent-id>.json
    approvals/<approval-id>.json
  history/runs/<run-id>.json

التجاوز بمتغيرات البيئة

REEVES_REGISTRY

يغيّر المجلد الجذري لبيانات الحالة (الافتراضي: ~/.reeves).

REEVES_CONFIG

يغيّر مسار ملف الإعداد.

REEVES_NO_TMUX_WRAPPER=1

عند ضبطه على 1، يعطّل لفّ TUI تلقائيًا في جلسة tmux.

REEVES_NO_COLOR=1

عند ضبطه على 1، يعطّل ألوان TUI.

ALLOW_DESTRUCTIVE=1

عند ضبطه على 1، يسمح بالأوامر التدميرية من دون --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

عند ضبطه على 1، يتجاوز فحص توافق المزوّدين في doctor.

المزوّدون

25 أداة CLI، لكل منها معرّف قصير تكتبه في مواصفة spawn. قوائم النماذج اقتراحات، وأي معرّف نموذج تمرّره يذهب إلى المزوّد كما هو.

  • Claude Codeمضيف MCP

    مساعد البرمجة من Anthropic للطرفية

    المعرّف ccالملف التنفيذي claude

    النماذج المقترحة fable, opus, sonnet, haiku

  • Codex CLIمضيف MCP

    أداة CLI لمساعد البرمجة من OpenAI

    المعرّف codexالملف التنفيذي codex

    النماذج المقترحة gpt-5.6-sol, gpt-5.5, gpt-5.4-mini

  • OpenCode CLIمضيف MCP

    مساعد برمجة مفتوح المصدر للطرفية

    المعرّف opencodeالملف التنفيذي opencode

    النماذج المقترحة opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5

  • Hermesمضيف MCP

    أداة CLI للمساعد من Nous Research

    المعرّف hermesالملف التنفيذي hermes

    النماذج المقترحة anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini

  • Kimi Codeمضيف MCP

    أداة CLI للبرمجة من Moonshot AI

    المعرّف kimiالملف التنفيذي kimi

    النماذج المقترحة kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    أداة CLI للبرمجة من DeepSeek

    المعرّف deepseekالملف التنفيذي deepseek

    النماذج المقترحة deepseek-v4-pro, deepseek-v4-flash

  • Pi

    إطار برمجة مصغّر للطرفية

    المعرّف piالملف التنفيذي pi

    النماذج المقترحة sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen Codeمضيف MCP

    أداة CLI لمساعد البرمجة من Alibaba

    المعرّف qwenالملف التنفيذي qwen

    النماذج المقترحة qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    برمجة زوجية بالذكاء الاصطناعي في الطرفية

    المعرّف aiderالملف التنفيذي aider

    النماذج المقترحة sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    مساعد طرفية مفتوح المصدر من Google

    المعرّف geminiالملف التنفيذي gemini

    النماذج المقترحة gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite

  • Cline CLI

    أداة CLI لمساعد برمجة مستقل

    المعرّف clineالملف التنفيذي cline

    النماذج المقترحة anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro

  • Crush

    مساعد البرمجة من Charm للطرفية

    المعرّف crushالملف التنفيذي crush

    النماذج المقترحة يُختار داخل CLI نفسها

  • Goose

    مساعد ذكاء اصطناعي متعدد الأغراض ومفتوح المصدر

    المعرّف gooseالملف التنفيذي goose

    النماذج المقترحة claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro

  • Kilo Code

    مساعد برمجة مفتوح المصدر مع أداة CLI

    المعرّف kiloالملف التنفيذي kilo

    النماذج المقترحة kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest

  • Letta Code

    مساعد برمجة بذاكرة طويلة الأمد

    المعرّف lettaالملف التنفيذي letta

    النماذج المقترحة zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct

  • Mistral Vibe

    أداة CLI لمساعد البرمجة من Mistral

    المعرّف vibeالملف التنفيذي vibe

    النماذج المقترحة يُختار داخل CLI نفسها

  • Grok Build

    أداة CLI لمساعد البرمجة من xAI

    المعرّف grokالملف التنفيذي grok

    النماذج المقترحة grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    أداة CLI للبرمجة بالوكلاء من AWS

    المعرّف kiroالملف التنفيذي kiro-cli

    النماذج المقترحة claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    أداة CLI لمساعد البرمجة من Factory

    المعرّف droidالملف التنفيذي droid

    النماذج المقترحة يُختار داخل CLI نفسها

  • Qoder CLI

    أداة CLI للبرمجة بالوكلاء من Qoder

    المعرّف qoderالملف التنفيذي qodercli

    النماذج المقترحة auto, performance, lite

  • Warp

    مساعد Warp في الطرفية

    المعرّف warpالملف التنفيذي warp

    النماذج المقترحة يُختار داخل CLI نفسها

  • Junie CLI

    أداة CLI لمساعد البرمجة من JetBrains

    المعرّف junieالملف التنفيذي junie

    النماذج المقترحة sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    أداة CLI لمساعد البرمجة من GitHub

    المعرّف copilotالملف التنفيذي copilot

    النماذج المقترحة auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    أداة CLI لمساعد البرمجة من Cursor

    المعرّف cursorالملف التنفيذي cursor-agent

    النماذج المقترحة gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    أداة CLI لمساعد البرمجة من Atlassian

    المعرّف rovoالملف التنفيذي acli

    النماذج المقترحة يُختار داخل CLI نفسها

  • يضبط --effort جهد الاستدلال في Claude Code وCodex. ويسري --auth-mode api-key على Claude Code.
  • مرّر أي خيار إطلاق آخر بـ --extra-args، مثل --remote-control في Claude Code.
  • أبقِ طلبات الإذن مفعّلة. يعطّلها --skip في أدوات البرمجة.

أدوات المساعدين

أربع أدوات CLI مساعدة يستطيع المساعد تشغيلها من الطرفية الخاصة به. لا تقبل مهمة محادثة، لذا فهي ليست مزوّدين يمكن تشغيلهم. يعرضها reevesagents tools مع حالة التثبيت وتسجيل الدخول.

  • Perplexity CLIpplx

    بحث في الويب ومقتطفات من الصفحات عبر Perplexity، بصيغة JSON.

  • Google Colab CLIcolab

    بيئات تشغيل CPU وGPU وTPU على Google Colab:‎ شغّل السكربتات والدفاتر عن بُعد.

  • Hugging Face CLIhf

    نزّل النماذج ومجموعات البيانات وارفعها، وشغّل المهام على Hugging Face Hub.

  • Ollamaollama

    شغّل نماذج محلية أو نماذج Ollama السحابية من الطرفية.

استكشاف الأخطاء وإصلاحها

ابدأ بـ reevesagents doctor، فهو يسمّي المشكلة في العادة.

tmux غير مثبّت

ثبّته بـ brew install tmux أو sudo apt install tmux، ثم شغّل doctor مرة أخرى.

أحد المزوّدين لا يظهر

في الغالب تكون أداة CLI غير مثبّتة أو غير مسجَّل الدخول فيها. عالج ذلك، ثم تحقّق بـ reevesagents providers.

واجهة Web UI تشكو من حزم ناقصة

تحتاج الطرفية الحية إلى الوحدتين الاختياريتين ws و@lydell/node-pty. أعد التثبيت العام بـ npm أو pnpm لتستعيدهما.

المنفذ 8080 مشغول

تنتقل واجهة Web UI إلى أول منفذ حر وتطبع الرابط. ولتختار منفذًا بنفسك استخدم reevesagents web --port 8090.

Windows الأصلي

شغّل المنتج الكامل داخل WSL. وللتحكم بالوكلاء وحده، تعمل reevesagents-win على Windows مباشرة بوصفها خادم MCP.

أرقام يمكنك التحقق منها

فترة التنزيلات: من 2025-04-14 إلى 2026-10-14. تحقّقنا من أرقام GitHub وnpm في 2026-10-15. التنزيلات تحصي طلبات الحزم.

آخر تحديث: