Standalone Agent Orchestrator

Bir sohbet. Birden fazla ajan. Kontrol sizde.

Codex ve Claude Code için yerel, kalıcı ve iç içe alt ajan orkestrasyonu. MCP ile bağlanın. Görevleri dağıtın. Aynı oturumda devam edin.

Android ve sesli asistan · Hızlı başlangıç · Nasıl çalışır? · Araçlar · Belgeler · Katkı

Local MCP orchestration for Codex and Claude Code. Durable tasks, nested delegation, and explicit permission boundaries.

“Bu üç işi incele. Her biri için bir alt ajan başlat. Gerekirse kendi test ajanlarını açsınlar. Ben ana sohbette devam ederken sonuçları topla.”

Bu proje, bu akışı MCP destekleyen bir istemciden yürütmenizi sağlar. Her görev kendi sağlayıcı oturumunu, tur geçmişini ve sonuçlarını korur. Ana sohbetten yeni bilgi gönderebilir, belirli bir sonucu bekleyebilir veya bütün bir alt ağacı iptal edebilirsiniz.

T3 kurulumu, T3 hesabı veya T3 çalışma zamanı gerekmez. Sağlayıcıların bilgisayarınızdaki CLI araçlarını ve mevcut girişlerini kullanır. Model çağrıları ilgili sağlayıcıya gider; orkestrasyon servisi ve görev kayıtları yereldir.

Neler sunar?

Related MCP server: deepseek_harness

Nasıl çalışır?

flowchart TB
    U["Ana sohbet · Codex / Claude Code / VS Code"]
    M["MCP köprüsü"]
    O["Yerel orkestrasyon servisi"]
    D[("SQLite · görevler, turlar, bildirimler")]
    A["İş A · Codex"]
    B["İş B · Claude Code"]
    C["İş C · Codex"]
    T["Test ajanı"]
    R["İnceleme ajanı"]
    U <--> M
    M <--> O
    O <--> D
    O --> A & B & C
    A --> T
    B --> R
    classDef control fill:#eef2ff,stroke:#6366f1,color:#312e81
    classDef agent fill:#ecfdf5,stroke:#10b981,color:#064e3b
    class U,M,O,D control
    class A,B,C,T,R agent

MCP köprüsünün kapanması görevleri durdurmaz; onları bağımsız yerel servis yönetir. Çocuk sonuçları doğrudan çağıran üst ajana döner. Varsayılan sınır üç ajan katmanı, katman başına dört çalışan süreçtir; ana sohbet katmana dahil değildir.

Hızlı başlangıç

1. Gereksinimleri hazırlayın

• Node.js ≥ 22.16 ve npm.

• macOS veya Linux. Yerel Windows desteği yok; WSL2 henüz doğrulanmadı.

• Kullanacağınız sağlayıcı için kurulu, giriş yapılmış CLI: codex login ve/veya claude auth login.

• Worktree kullanacaksanız Git ve en az bir commit içeren depo.

2. Paketi kurun

v0.1.1 release paketini doğrudan kurabilirsiniz:

npm install -g https://github.com/muratangin187/subagent-orchestrator/releases/download/v0.1.1/standalone-agent-orchestrator-0.1.1.tgz
agent-orchestrator doctor

git clone https://github.com/muratangin187/subagent-orchestrator.git
cd subagent-orchestrator
npm ci
npm run build
npm pack
npm install -g ./standalone-agent-orchestrator-0.1.1.tgz

Paket henüz npm kayıt sisteminde yayımlanmadı. npx standalone-agent-orchestrator ile yayımlanmış bir paket indireceğinizi varsaymayın.

3. İstemcinize bağlayın

Örneklerdeki /absolute/path/to/project değerini kendi proje yolunuzla değiştirin. Varsayılan yetki salt okunurdur.

[mcp_servers.subagent_orchestrator]
command = "agent-orchestrator"
args = ["mcp", "--cwd", "/absolute/path/to/project"]
tool_timeout_sec = 75

{
  "mcpServers": {
    "subagent_orchestrator": {
      "command": "agent-orchestrator",
      "args": ["mcp", "--cwd", "/absolute/path/to/project"]
    }
  }
}

{
  "servers": {
    "subagent_orchestrator": {
      "type": "stdio",
      "command": "agent-orchestrator",
      "args": ["mcp", "--cwd", "/absolute/path/to/project"]
    }
  }
}

İstemcinizde MCP bağlantısını etkinleştirin ve oturumu/araç listesini yenileyin. Komut bulunamıyorsa command alanına agent-orchestrator dosyasının mutlak yolunu yazın. agent-orchestrator config --cwd /absolute/path/to/project bu örnekleri üretir; dosyalarınızı değiştirmez.

4. İlk görevi verin

Ana sohbetinize şunu yazın:

subagent_orchestrator ile önce yetenekleri ve çalışma dizinini kontrol et. Codex ile bir mimari inceleme, Claude ile bir test kapsamı incelemesi başlat. Dosyaları değiştirmesinler. Sonuçları bekle, başarısızlıkları açıkça belirt ve bulguları birleştir.

Her görev kendi başına anlaşılır bir brief almalıdır. İlgili dosyaları, hedefi ve beklenen çıktıyı belirtin. Yalnızca kullandığınız sağlayıcının kurulu olması yeterlidir; iki sağlayıcılı bu örnek ikisini de gerektirir.

Bir görevin yaşam döngüsü

Aşağıdakiler MCP araç çağrılarının giriş örnekleridir. TASK_ID ve RUN_ID yerlerine dönen gerçek UUID değerlerini kullanın.

Başlat · delegate_task

{
  "task": "Kimlik doğrulama akışını incele. Dosyaları değiştirme. Üç somut risk ve ilgili dosya yollarını raporla.",
  "provider": "codex",
  "role": "review",
  "mode": "async",
  "clientRequestId": "auth-review-1"
}

Bekle · wait_for_task

{ "taskId": "TASK_ID", "runId": "RUN_ID", "timeoutMs": 45000 }

Bekleme süresinin dolması iptal değildir. taskId konuşmayı, runId belirli bir turu tanımlar. Sonraki mesajın yeni turunu önceki tamamlanmış sonuçla karıştırmayın.

Bağlamı güncelle · send_to_subagent

{
  "taskId": "TASK_ID",
  "message": "Yeni bilgi: eski giriş akışı kaldırılıyor. İncelemeyi yeni akışla sınırla.",
  "mode": "queue",
  "clientRequestId": "auth-review-update-1"
}

Aynı isteği ağ hatası sonrası tekrarlarken aynı clientRequestId ve içeriği kullanın. Yeni iş için yeni kimlik üretin. Sistem belirsiz sağlayıcı yan etkilerini otomatik tekrar etmez.

MCP araçları

Olay ve bildirim okumalarında nextOffset değerini sonraki çağrının sinceOffset alanına taşıyın. Bildirimler okununca silinmez.

Kontrol sizde

Modeller ve CLI sürümleri

model alanına sağlayıcının kabul ettiği kimliği verin. Sistem desteklenmeyen bir modeli sessizce başka bir modelle değiştirmez. Alan boşsa kök görev sağlayıcının varsayılanını kullanır; aynı sağlayıcıdaki çocuk üst modelini devralır.

agent-orchestrator models     # Çalışan servisin Codex model kataloğu
agent-orchestrator doctor     # Kabuktaki CLI kurulumları ve sürümleri

Birden fazla CLI kurulumu varsa ORCHESTRATOR_CODEX_BIN veya ORCHESTRATOR_CLAUDE_BIN ile mutlak yol seçebilirsiniz. Model kataloğu, ana uygulamanızın kataloğuyla aynı olmayabilir. CLI yolu sorun giderme →

İzinler ve worktree

Yazma izni için MCP argümanlarına --ceiling auto-accept-edits ekleyin. Tavanı ana oturumun gerçek izinlerinden geniş tutmayın. Çocuklar bu tavanı yükseltemez; --plan salt okunur çalışmayı zorlar.

Bağımsız uygulama görevlerinde isolation: "worktree" seçin. Ayrı checkout, görev kabulündeki commit'ten oluşturulur. Kaydedilmemiş değişiklikler kopyalanmaz; bağımlılıklar otomatik kurulmaz. Worktree'ler incelemeniz için korunur; otomatik merge veya silme yapılmaz.

Kota ve kesinti

• Kota dolduğunda: Görev failed olur. Üst ajana usage_limit veya rate_limit, sağlayıcı ve varsa resetHint gider. Sıradaki mesajlar bekletilir; otomatik tekrar yapılmaz.

• Servis çöktüğünde: Belirsiz aktif işler recovery_required olur. Önce kayıtları ve dosyaları inceleyin; sonra açık devam mesajı gönderin.

• Köprü kapandığında: Servis ve görevler çalışmayı sürdürür. Sohbeti kapatmayı iptal olarak kabul etmeyin.

agent-orchestrator status
agent-orchestrator stop       # Bu veri alanındaki bütün aktif sağlayıcı süreçlerini durdurur

Tek görevi durdurmak için cancel_task kullanın. Görev geçmişi varsayılan olarak ~/.local/share/agent-orchestrator/ altında kalır.

Her MCP köprüsü varsayılan olarak farklı ana oturum kimliği üretir. Önceki işlerinize yeniden bağlanmak için orchestrator_capabilities çıktısındaki scope.id değerini --parent argümanı olarak saklayın. Aynı kimliği bağımsız sohbetlere ortak vermeyin.

Servis başlamadan önce ORCHESTRATOR_MAX_DEPTH (1–8, varsayılan 3) ve ORCHESTRATOR_CONCURRENCY_PER_DEPTH (1–16, varsayılan 4) ayarlanabilir. İlk köprünün başlattığı servis ortamı korur; değişiklik için aktif işleri güvenli biçimde bitirip servisi yeniden başlatın.

Aynı çalışma dizinindeki yazabilen görevler sırayla çalışır. Yazan üst ajan aynı dizindeki yazan çocuğunu beklemeli veya ayrı worktree kullanmalıdır. Üst ajanların beklemesi diğer derinliklerin işlem yuvalarını tüketmez.

Sınırlar ve güvenlik

• Yerel işletim sistemi kullanıcısı güven sınırıdır; çok kiracılı servis veya düşman kod sandbox'ı değildir.

• Konuşma ve görev verileri diskte tutulur; şifreleme ve otomatik silme yoktur.

• Çocuklar ana konuşmayı veya ana ajanın diğer MCP bağlantılarını otomatik devralmaz.

• Sağlayıcı hesap kotaları ve ücretleri geçerlidir. Model harcama üst sınırı uygulanmaz.

• Bir tur en fazla 30 dakika; en fazla 1.000 açık görev ve görev başına 100 kuyruk mesajı.

• Girdi 64.000, saklanan sonuç 128.000 karakterle sınırlıdır.

• Gerçek sağlayıcı testleri macOS'ta yapıldı. Linux/WSL üzerinde gerçek model testi iddia edilmiyor; CI durumu yukarıdaki rozette görünür.

Ayrıntılar: güvenlik politikası · izinler ve veri yaşam döngüsü.

Geliştirme

npm ci
npm run format:check
npm run check
npm test
npm run build

34 otomatik test: görev yaşam döngüsü, iç içe delegasyon, izinler, kota bildirimleri, süreç çökmesi, kalıcı kayıtlar, MCP bağlantısı ve worktree davranışı. Normal testler model hesabı veya API anahtarı istemez.

npm run test:live
npm run test:live:controls
npm run test:live:nesting

Bu komutlar mevcut sağlayıcı girişlerinizi kullanır ve kota tüketebilir. Geçici çalışma dizinlerinde çalışırlar. Önceki başarılı senaryolar, kota nedeniyle tamamlanamayan tekrarlar ve doğrulanan sürümler doğrulama kaydında ayrı belirtilir.

Belgeler

Yol haritası

Gelecekte görev ağacını, konuşmaları ve olayları incelemek için görsel bir arayüz hedefleniyor. Mevcut servis ve kayıt yapısı buna temel olacak. Bu bir teslim tarihi veya mevcut özellik vaadi değildir.

Katkı ve kaynaklar

Hata raporları ve somut iyileştirme önerileri için issue açın. Kod katkısı için katkı rehberini izleyin. Güvenlik açıklarını public issue yerine özel olarak bildirin.

Tasarım sırasında T3 Code orkestrasyon yaklaşımı incelendi. İncelenen sürüm ve kaynaklar mimari belgesinde listelenir. T3 çalışma zamanı kodu veya paket bağımlılığı bu projeye taşınmadı.

MIT lisansı · Yerel orkestrasyon, açık kaynak.

Android uygulaması · 0.2.0-alpha.1

Bilgisayarındaki ajanlar, cebindeki tek asistan. Tailscale üzerinden yerel sunucuna bağlan; aynı Codex asistanına yaz veya konuş. Uzun işler alt ajanlarda ilerlerken başka konulara geçebilir, sonuçları aynı sohbetten takip edebilirsin.

APK indir → · Kurulum ve sınırlar · Release derleme

1. Bilgisayarına aynı release içindeki Node paketini kur.

2. Sunucuyu başlat ve Tailscale HTTPS'i ayarla.

3. Android 9+ telefonuna APK'yı yükle; adres ve tek kullanımlık kodla eşleştir.

4. Sesli görüşme için Ayarlar bölümüne kendi ElevenLabs anahtarını ekle.

Alpha sürüm: Public APK kişisel Firebase yapılandırması içermez; ön planda güncellemeler çalışır. Ekran kapalı bildirim için kendi Firebase projenle derle. Bilgisayar açık ve erişilebilir olmalı. Sesli görüşme sırayla konuşma/yanıt alma şeklindedir; tam çift yönlü değildir. ElevenLabs ses ve yanıt metnini işler. Slack/e-posta entegrasyon profilleri henüz uygulamaya taşınmadı.