Karavi: Created page with "= Agentic Development OS Tools = این صفحه مجموعه ابزارهای Agentic Development OS نصب‌شده و تست‌شده را برای مدیریت Coding Agentها مستند می‌کند. هدف اصلی ایجاد یک محیط یکپارچه برای مدیریت Agentهایی مانند: * Claude Code * OpenAI Codex * Cursor Agent * OpenCode * Google Antigravity * Freebuff * Gemini CLI * سایر CLI Agentها است. اهداف اصلی این..."

2026-08-20T21:56:42Z

Created page with "= Agentic Development OS Tools = این صفحه مجموعه ابزارهای Agentic Development OS نصب‌شده و تست‌شده را برای مدیریت Coding Agentها مستند می‌کند. هدف اصلی ایجاد یک محیط یکپارچه برای مدیریت Agentهایی مانند: * Claude Code * OpenAI Codex * Cursor Agent * OpenCode * Google Antigravity * Freebuff * Gemini CLI * سایر CLI Agentها است. اهداف اصلی این..."

New page

= Agentic Development OS Tools =

این صفحه مجموعه ابزارهای Agentic Development OS نصب‌شده و تست‌شده را برای مدیریت Coding Agentها مستند می‌کند.

هدف اصلی ایجاد یک محیط یکپارچه برای مدیریت Agentهایی مانند:

* Claude Code
* OpenAI Codex
* Cursor Agent
* OpenCode
* Google Antigravity
* Freebuff
* Gemini CLI
* سایر CLI Agentها

است.

اهداف اصلی این محیط:

* مدیریت چند Agent از یک UI
* اجرای Parallel Agentها
* مدیریت Sessionها
* Git Worktree Isolation
* Skills
* Memory
* Token / Cost Management
* Context Optimization
* Multi-Agent Orchestration
* LLM-as-a-Judge
* Automated Testing / Review
* کمترین تعداد نرم‌افزار ممکن
* پشتیبانی مناسب Windows

== نرم‌افزارهای نصب‌شده ==

{| class="wikitable sortable"
! نرم‌افزار
! نوع
! UI
! Windows
! وضعیت
|-
| '''OpenHands Agent Canvas'''
| Agentic Platform / Control Center
| Web
| بله
| نصب و در حال ارزیابی
|-
| '''Orca'''
| Agent Development Environment (ADE)
| Desktop
| بله
| نصب و در حال ارزیابی
|-
| '''Codbash'''
| Coding Agent Control Room
| Web
| بله
| نصب و تست‌شده
|-
| '''Claw Orchestrator'''
| Multi-Agent Runtime / Orchestrator
| Web Dashboard
| بله
| نصب و تست‌شده
|-
| '''Agent Orchestrator (AO)'''
| Agentic IDE / Agent Orchestrator
| Desktop
| بله
| نصب؛ در Windows با مشکل Daemon مواجه شد
|}

= 1. OpenHands Agent Canvas =

== معرفی ==

OpenHands Agent Canvas یک Developer Control Center برای اجرای Coding Agentها و Automationها است.

Agent Canvas می‌تواند به Agent Backendهای مختلف متصل شود و Agentها را به صورت Local، Remote، Docker، VM یا Cloud اجرا کند.

پشتیبانی مهم:

* OpenHands
* Claude Code
* OpenAI Codex
* Gemini
* ACP-compatible Agents
* Local/Remote Agent Backends
* Automations

== وب‌سایت و سورس ==

* Documentation:
https://docs.openhands.dev/

* GitHub:
https://github.com/OpenHands/OpenHands

* npm:
https://www.npmjs.com/package/@openhands/agent-canvas

== نصب روی Windows ==

پیش‌نیاز اصلی:

<syntaxhighlight lang="powershell">
node --version
npm --version
</syntaxhighlight>

Node.js باید نسخه مناسب Agent Canvas باشد.

نصب:

<syntaxhighlight lang="powershell">
npm install -g @openhands/agent-canvas
</syntaxhighlight>

در صورت Block شدن install scriptها توسط npm:

<syntaxhighlight lang="powershell">
npm config set allow-scripts=@openhands/agent-canvas,@heroui/shared-utils,@openrouter/sdk,core-js --location=user

npm rebuild -g @openhands/agent-canvas
</syntaxhighlight>

== اجرا ==

<syntaxhighlight lang="powershell">
agent-canvas
</syntaxhighlight>

در صورت مشکل PowerShell:

<syntaxhighlight lang="powershell">
agent-canvas.cmd
</syntaxhighlight>

سرویس Local به صورت پیش‌فرض روی:

<pre>
http://localhost:8000
</pre>

اجرا می‌شود.

== معماری ==

<pre>
Agent Canvas
|
+-- OpenHands Agent
|
+-- Claude Code
|
+-- Codex
|
+-- Gemini
|
+-- ACP Agents
|
+-- Agent Server
|
+-- Automation Server
</pre>

== مزایا ==

* پروژه Open Source بزرگ و شناخته‌شده
* UI تحت Web
* معماری Agent Server
* Automation
* امکان اتصال چند Backend
* امکان اجرای Local و Remote
* امکان استفاده از Docker Sandbox
* پشتیبانی ACP
* مناسب برای توسعه Agentic Platform

== معایب برای نیاز من ==

* بیشتر Agent Platform است تا Desktop IDE مخصوص Coding CLIها
* اتصال Cursor/OpenCode/Antigravity ممکن است به اندازه Orca مستقیم نباشد
* برای Sandbox کامل ممکن است Docker لازم شود
* معماری آن نسبت به Codbash پیچیده‌تر است

= 2. Orca =

== معرفی ==

Orca یک:

'''Agent Development Environment (ADE)'''

برای مدیریت Fleetای از Coding Agentها است.

هدف اصلی آن اجرای چند Coding Agent به صورت Parallel و ایزوله کردن آنها با Git Worktree است.

== وب‌سایت و سورس ==

* Website:
https://www.onorca.dev/

* GitHub:
https://github.com/stablyai/orca

* Releases:
https://github.com/stablyai/orca/releases

== نصب روی Windows ==

نسخه Windows به صورت Desktop Application ارائه می‌شود.

دانلود:

https://www.onorca.dev/

یا:

https://github.com/stablyai/orca/releases

== Agentهای مهم پشتیبانی‌شده ==

Orca می‌تواند CLI Agentهای زیادی را اجرا کند.

از جمله:

* Claude Code
* Codex
* Cursor
* OpenCode
* Antigravity
* GitHub Copilot
* Pi
* Hermes Agent
* Kimi
* Kiro
* Qwen Code
* Cline
* Continue
* Droid
* Goose
* Devin
* سایر CLI Agentها

== معماری ==

<pre>
ORCA
|
Desktop Control Plane
|
+------------+-------------+
| | |
Claude Codex Cursor
| | |
OpenCode Agy Other
| | |
+------------+-------------+
|
Git Worktrees
|
Parallel Agents
|
Diff / Review
</pre>

== Parallel Worktrees ==

یکی از مهم‌ترین قابلیت‌های Orca اجرای یک Prompt روی چند Agent است.

هر Agent می‌تواند Worktree مستقل داشته باشد:

<pre>
Repository
|
+-- Worktree Claude
|
+-- Worktree Codex
|
+-- Worktree Cursor
|
+-- Worktree OpenCode
|
+-- Worktree Antigravity
</pre>

در نتیجه Agentها فایل‌های یکدیگر را overwrite نمی‌کنند.

== مزایا ==

* Windows Native
* Desktop UI
* تعداد بسیار زیاد Agent
* Claude Code
* Codex
* Cursor
* OpenCode
* Antigravity
* Custom CLI
* Parallel Agents
* Git Worktrees
* Diff Review
* Terminal Splits
* Usage Tracking
* Rate Limit Tracking
* Local-first
* Open Source
* MIT License

== معایب برای نیاز من ==

* Memory مرکزی در سطح Agentic OS هنوز نقطه اصلی محصول نیست
* Skills System به قدرت سیستم‌های Agent Platform نیست
* LLM-as-a-Judge کامل باید Workflow اختصاصی داشته باشد
* Context Optimization پیشرفته نیاز به بررسی بیشتر دارد

= 3. Codbash =

== معرفی ==

Codbash یک Browser Dashboard برای مدیریت Coding Agent Sessionها است.

بیشتر شبیه:

'''AI Coding Agent Control Room'''

عمل می‌کند.

== GitHub ==

https://github.com/vakovalskii/codbash

== نصب روی Windows ==

پیش‌نیاز:

<syntaxhighlight lang="powershell">
node --version
npm --version
</syntaxhighlight>

نصب:

<syntaxhighlight lang="powershell">
npm install -g codbash-app
</syntaxhighlight>

== بررسی نسخه ==

<syntaxhighlight lang="powershell">
codbash --version
</syntaxhighlight>

== اجرا ==

<syntaxhighlight lang="powershell">
codbash run
</syntaxhighlight>

UI در Browser اجرا می‌شود.

== Agentهای پشتیبانی‌شده ==

از جمله:

* Claude Code
* Codex
* Cursor
* OpenCode
* Qwen
* Pi
* Oh My Pi
* Kiro
* Kilo
* Copilot Chat

== امکانات ==

* Browser Dashboard
* Session Management
* Session Search
* Session Replay
* Resume
* Live Status
* Terminal
* Split Terminal
* Project Management
* Cost Analytics
* Token Usage
* Handoff
* Cross-Agent Session Conversion

== Analytics ==

Codbash می‌تواند اطلاعات مصرف را از Agentهایی که Usage ثبت می‌کنند استخراج کند.

از جمله:

* Input Tokens
* Output Tokens
* Cache Usage
* Cost
* Cost per Model
* Cost per Project
* Cost per Session

== معماری ==

<pre>
Codbash
|
Browser Dashboard
|
+------------+------------+
| | |
Claude Codex OpenCode
| | |
Cursor Kiro Qwen
|
+---- Sessions / History
|
+---- Token / Cost Analytics
</pre>

== مزایا ==

* نصب بسیار ساده
* Windows
* Web UI
* Session Management قوی
* Token/Cost Analytics
* Claude/Codex/Cursor/OpenCode
* Search
* Replay
* Handoff
* Terminal Splits
* سبک

== مشکلات مشاهده‌شده ==

در تست Windows مشکل PowerShell Execution Policy برای بعضی CLIهای npm مانند OpenCode مشاهده شد.

راه‌حل:

<syntaxhighlight lang="powershell">
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
</syntaxhighlight>

همچنین UI فعلی برای متن فارسی/RTL ایده‌آل نیست.

== معایب برای Agent OS ==

Codbash بیشتر Session Manager / Control Room است.

قابلیت‌های زیر هسته اصلی آن نیستند:

* Skills پیشرفته
* Project Memory پیشرفته
* Context Optimization
* LLM-as-a-Judge
* Agent Planning
* Autonomous Multi-Agent Workflow

بنابراین به تنهایی Agentic OS کامل موردنظر من نیست.

= 4. Claw Orchestrator =

== معرفی ==

Claw Orchestrator یک Multi-Engine Coding Agent Runtime است.

Coding CLIها را به Persistent Programmable Agent تبدیل می‌کند.

== GitHub ==

https://github.com/Enderfga/claw-orchestrator

== نصب ==

<syntaxhighlight lang="powershell">
npm install -g @enderfga/claw-orchestrator
</syntaxhighlight>

== بررسی ==

<syntaxhighlight lang="powershell">
clawo --version
clawo --help
</syntaxhighlight>

== npm Allow Scripts ==

در Windows ممکن است npm بعضی install scriptها را Block کند.

نمونه:

<syntaxhighlight lang="powershell">
npm config set allow-scripts=openclaw,re2,@google/genai,tree-sitter-bash,protobufjs --location=user
</syntaxhighlight>

== مشکل RE2 در Windows ==

خطای مشاهده‌شده:

<pre>
Cannot find module './build/Release/re2.node'
</pre>

راه‌حل استفاده‌شده:

<syntaxhighlight lang="powershell">
cd "$env:APPDATA\npm\node_modules\@enderfga\claw-orchestrator"

npm rebuild re2
</syntaxhighlight>

== اجرا ==

<syntaxhighlight lang="powershell">
clawo serve
</syntaxhighlight>

Server معمولاً روی:

<pre>
http://127.0.0.1:18796
</pre>

اجرا می‌شود.

== Agentهای مهم ==

* Claude Code
* Codex
* Antigravity
* Cursor Agent
* OpenCode
* Custom CLI

== Persistent Session ==

نمونه:

<syntaxhighlight lang="powershell">
clawo session-start claude-main `
--engine claude `
--cwd "D:\SourceKaravi\GitHub\MyProject"
</syntaxhighlight>

ارسال Task:

<syntaxhighlight lang="powershell">
clawo session-send claude-main "Analyze this repository."
</syntaxhighlight>

لیست Sessionها:

<syntaxhighlight lang="powershell">
clawo session-list
</syntaxhighlight>

وضعیت:

<syntaxhighlight lang="powershell">
clawo session-status claude-main
</syntaxhighlight>

== Council ==

Council برای اجرای چند Agent/Model روی یک مسئله و جمع‌آوری دیدگاه‌های مختلف طراحی شده است.

می‌توان از آن برای:

* Architecture Review
* Code Review
* Design Decision
* Multi-Agent Analysis
* Candidate Comparison

استفاده کرد.

== Forge ==

Forge برای Workflowهای سطح بالاتر و ساخت Application/Artifact از طریق Agentها طراحی شده است.

== مزایا ==

* Multi-Agent Runtime واقعی
* Persistent Sessions
* Claude
* Codex
* Cursor
* OpenCode
* Antigravity
* Custom CLI
* Council
* Autoloop
* Worktree control
* MCP
* OpenClaw integration
* API
* OpenAI-compatible Proxy

== معایب ==

* Dashboard برای استفاده روزانه من جذاب نبود
* UI نسبت به Orca ضعیف‌تر است
* بیشتر Runtime/API محور است
* Windows npm native dependencyها ممکن است نیاز به تعمیر داشته باشند

= 5. Agent Orchestrator (AO) =

== معرفی ==

Agent Orchestrator یک Agentic IDE برای مدیریت Fleetای از Coding Agentها است.

هدف آن اجرای Parallel Agentها در Workspaceهای جدا و مدیریت Feedback Loop است.

== وب‌سایت و سورس ==

* Website:
https://aoagents.dev/

* GitHub:
https://github.com/Untrivial-ai/agent-orchestrator

* Releases:
https://github.com/Untrivial-ai/agent-orchestrator/releases

== نصب ==

روش پیشنهادی فعلی استفاده از Desktop Build است.

نسخه‌های:

* Windows
* macOS
* Linux

وجود دارند.

روش npm قدیمی است و برای نصب جدید توصیه نمی‌شود.

== معماری ==

<pre>
Agent Orchestrator
|
Desktop UI
|
Orchestrator
|
+-------------+-------------+
| | |
Claude Codex Cursor
| | |
OpenCode Kimi ...
|
+---- Git Worktrees
|
+---- Pull Requests
|
+---- CI Feedback
|
+---- Review Feedback
</pre>

== قابلیت‌های مهم ==

* Parallel Agents
* Git Worktree Isolation
* Live Terminals
* Session State
* Pull Request Awareness
* CI Feedback
* Review Feedback
* Merge Conflict Feedback
* Reviewer Agents
* Desktop UI

== مشکل مشاهده‌شده روی Windows ==

در تست انجام‌شده Daemon با خطای:

<pre>
seed scratch project: Failed to load projects
</pre>

متوقف شد.

دیتابیس محلی:

<pre>
C:\Users\karavi\.ao\data\ao.db
</pre>

حتی بعد از Reset State نیز مشکل ادامه داشت.

بنابراین فعلاً برای استفاده اصلی کنار گذاشته شده است.

= مقایسه کلی =

{| class="wikitable sortable"
! قابلیت
! OpenHands Canvas
! Orca
! Codbash
! Claw Orchestrator
! Agent Orchestrator
|-
| Windows
| خوب
| '''عالی'''
| خوب
| خوب
| مشکل در تست
|-
| UI
| '''قوی'''
| '''عالی'''
| خوب
| متوسط
| خوب
|-
| Claude Code
| بله
| بله
| بله
| بله
| بله
|-
| Codex
| بله
| بله
| بله
| بله
| بله
|-
| Cursor
| از طریق معماری Agent/ACP نیازمند بررسی
| '''بله'''
| بله
| بله
| بله
|-
| OpenCode
| نیازمند بررسی Integration
| '''بله'''
| بله
| بله
| بله
|-
| Antigravity
| نیازمند Adapter
| '''بله'''
| خیر
| '''بله'''
| قابل استفاده به عنوان CLI
|-
| Custom CLI
| ACP
| '''بله'''
| محدود
| '''بله'''
| بله
|-
| Parallel Agents
| بله
| '''عالی'''
| بیشتر Parallel Terminal
| '''عالی'''
| '''عالی'''
|-
| Worktree
| قابل پیاده‌سازی
| '''عالی'''
| محدود
| بله
| '''عالی'''
|-
| Session Management
| خوب
| عالی
| '''عالی'''
| '''عالی'''
| عالی
|-
| Token Analytics
| متوسط
| خوب
| '''عالی برای مشاهده Cost'''
| خوب
| متوسط
|-
| Skills
| '''قوی‌تر'''
| متوسط
| ضعیف
| خوب
| متوسط
|-
| Memory
| '''قوی‌تر'''
| محدودتر
| Session History
| Session Context
| Session State
|-
| Automation
| '''عالی'''
| متوسط
| محدود
| '''عالی'''
| '''عالی'''
|-
| MCP/API
| '''عالی'''
| قابل توسعه
| محدود
| '''عالی'''
| خوب
|-
| LLM-as-a-Judge
| قابل ساخت
| قابل ساخت
| ضعیف
| '''Council مناسب'''
| Reviewer Workflow
|-
| نصب ساده
| متوسط
| '''عالی'''
| '''عالی'''
| متوسط
| عالی در حالت Desktop
|}

= مقایسه با Agentic OS موردنظر من =

Agentic OS ایده‌آل باید معماری زیر را داشته باشد:

<pre>
AGENTIC DEV OS
|
Unified UI
|
+----------------+----------------+
| | |
Skills Memory Projects
| | |
+----------------+----------------+
|
Context Manager
|
Token Optimization
|
Orchestrator
|
+---------+---------+---------+---------+
| | | | |
Claude Codex Cursor OpenCode Agy
| | | | |
+---------+---------+---------+---------+
|
Git Worktrees
|
Parallel Candidates
|
+------------------+------------------+
| | |
Build Tests Security
| | |
+------------------+------------------+
|
LLM Judge
|
Ranked Results
|
Human Approval
|
Commit / PR
</pre>

== نیازهای Critical ==

{| class="wikitable"
! نیاز
! اهمیت
|-
| UI مناسب
| Critical
|-
| Windows Native
| Critical
|-
| Claude Code
| Critical
|-
| Codex
| Critical
|-
| Cursor
| Critical
|-
| OpenCode
| Critical
|-
| Antigravity
| Critical
|-
| Multi-Agent
| Critical
|-
| Parallel Execution
| Critical
|-
| Git Worktrees
| Critical
|-
| Skills
| Critical
|-
| Memory
| Critical
|-
| Token Management
| Critical
|-
| Context Optimization
| Critical
|-
| LLM-as-a-Judge
| Critical
|-
| Automated Tests
| Critical
|-
| Security Review
| Critical
|-
| Human Approval
| Critical
|-
| کمترین تعداد نرم‌افزار
| Critical
|}

= ارزیابی نهایی =

== Orca ==

'''بهترین گزینه فعلی برای Control Plane'''

دلایل:

* UI بسیار مناسب
* Windows Native
* Claude
* Codex
* Cursor
* OpenCode
* Antigravity
* Custom CLI
* Worktrees
* Parallel Agents
* Diff Review
* Usage Tracking

ضعف اصلی:

* Skills / Memory / Judge / Context Intelligence هنوز نیازمند لایه مکمل هستند.

== OpenHands Agent Canvas ==

'''بهترین گزینه فعلی برای Agentic Platform'''

دلایل:

* Agent Server
* Automation
* Skills/Agent architecture
* Backend abstraction
* Remote execution
* ACP
* Local/Cloud architecture

ضعف:

برای مدیریت مستقیم تمام CLI Agentهای موجود به سادگی Orca نیست.

== Codbash ==

'''بهترین گزینه برای Session History و Cost Analytics سبک'''

مزایا:

* بسیار ساده
* Browser UI
* Session Search
* Replay
* Token/Cost Analytics
* Multi-terminal

اما Agentic OS کامل نیست.

== Claw Orchestrator ==

'''بهترین گزینه Runtime/API محور'''

مزایا:

* Multi-Agent
* Council
* Autoloop
* Persistent Sessions
* MCP
* API
* OpenClaw
* Antigravity
* Custom CLI

ضعف:

UI برای استفاده روزانه مطلوب نبود.

== Agent Orchestrator ==

از نظر معماری بسیار نزدیک به هدف است:

* Desktop
* Parallel Agents
* Worktrees
* CI Feedback
* Review Feedback
* PR Workflow

اما مشکل Daemon مشاهده‌شده در Windows باعث شده فعلاً انتخاب اصلی نباشد.

= پیشنهاد معماری فعلی =

اگر فقط یک نرم‌افزار انتخاب شود:

'''Orca'''

انتخاب فعلی مناسب‌تری است.

<pre>
Orca
|
+-----------+-----------+
| | |
Claude Codex Cursor
| | |
OpenCode Agy Custom
| | |
+-----------+-----------+
|
Worktrees
|
Diff / Review
</pre>

اگر دو لایه قابل قبول باشد:

<pre>
OpenHands Agent Canvas
Agentic Brain Layer
|
Automation / Agent Server
Memory / Skills / Backends
|
v
Orca
Development UI
|
+-------+-------+-------+-------+
| | | | |
Claude Codex Cursor OpenCode Agy
| | | | |
+-------+-------+-------+-------+
|
Git Worktrees
|
Build / Test
|
Review
|
LLM Judge
</pre>

این معماری باید در تست عملی اعتبارسنجی شود؛ مخصوصاً اتصال بین OpenHands و Orca نباید فرض شود که به صورت Native وجود دارد.

= Workflow پیشنهادی Agentic Development =

<pre>
Task
|
+--> Architect Agent
|
+--> Claude Implementation -----+
| |
+--> Codex Implementation -------+--> Build
| | |
+--> OpenCode Implementation ----+ Tests
|
Security
|
Review
|
LLM Judge
|
Human Approval
|
Commit / PR
</pre>

= Rubric پیشنهادی LLM-as-a-Judge =

{| class="wikitable"
! معیار
! وزن
|-
| Correctness
| 30%
|-
| Tests
| 20%
|-
| Architecture
| 15%
|-
| Security
| 15%
|-
| Code Quality
| 10%
|-
| Performance
| 5%
|-
| Token / Cost Efficiency
| 5%
|}

= نتیجه فعلی =

ترتیب فعلی برای ادامه تست:

# '''Orca''' — Control Plane اصلی
# '''OpenHands Agent Canvas''' — Agentic Platform
# '''Codbash''' — Session / Analytics Tool
# '''Claw Orchestrator''' — Runtime / Council / API
# '''Agent Orchestrator''' — فعلاً به علت مشکل Windows کنار گذاشته شده

هدف نهایی این است که پس از تست عملی، ابزارهای اضافی حذف شوند و در صورت امکان فقط یک یا حداکثر دو لایه باقی بمانند.

= منابع =

== OpenHands ==

* https://github.com/OpenHands/OpenHands
* https://docs.openhands.dev/
* https://www.npmjs.com/package/@openhands/agent-canvas

== Orca ==

* https://www.onorca.dev/
* https://github.com/stablyai/orca
* https://github.com/stablyai/orca/releases

== Codbash ==

* https://github.com/vakovalskii/codbash
* https://github.com/vakovalskii/codbash/releases

== Claw Orchestrator ==

* https://github.com/Enderfga/claw-orchestrator
* https://github.com/Enderfga/claw-orchestrator/releases

== Agent Orchestrator ==

* https://aoagents.dev/
* https://github.com/Untrivial-ai/agent-orchestrator
* https://github.com/Untrivial-ai/agent-orchestrator/releases

Ai Agentic os - Revision history

Karavi at 22:55, 20 August 2026