SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Omnigent nedir ve agent CLI araçları nasıl yönetilir?

Omnigent ile yüklü agent CLI araçlarını tek bir merkezden yönetin. 0.7.0 sürümünü sabitleme yöntemleri, VPS üzerinde sandbox kurulumu ve meta-harness yapısı hakkında bilgiler.

Omnigent nedir

Omnigent, halihazırda yüklü olan agent komut satırı araçlarını (CLI) yöneten tek bir orkestrasyon katmanı, yani açık kaynaklı bir meta-harness yapısıdır. Claude Code, Codex, Cursor, OpenCode, Hermes veya Pi gibi araçların yerini almaz. Bu araçları başlatır, her birine bir görev atar ve sonuçları tek bir oturumda, tek bir politika setiyle denetler. Databricks, depoyu Haziran 2026'da Apache 2.0 lisansı altında yayınlamıştır ve PyPI paketi hala alfa aşamasında olarak sınıflandırılmaktadır.

Sunduğu pratik fayda sınırlıdır ve açıkça belirtilmelidir. Bir agent'ı YAML formatında bir kez tanımlarsınız ve onu çalıştıracak harness'ı belirlersiniz. Sadece o satırı değiştirdiğinizde, aynı agent farklı bir sağlayıcının CLI aracı üzerinde çalışır. Kurulumunuzdaki başka hiçbir şey değişmez; çünkü Omnigent, agent'ların içindeki döngüyü değil, agent'ların üzerindeki döngüyü kontrol eder.

Meta-harness nedir ve bir framework'ten farkı nedir?

Harness, bir modeli döngü içerisinde sarmalayan programdır. İsteminizi okur, araçları çağırır, dosyaları düzenler ve geri bildirim sağlar. Claude Code bir harness'tır. Codex bir harness'tır. Kurulumunu yaparsınız, giriş yaparsınız ve kendi kendine çalışır.

Framework ise kodunuzu üzerine yazdığınız bir kütüphanedir. Onu içe aktarırsınız, adımları Python ile tanımlarsınız ve programınız bir ajana dönüşür. Orada sağlayıcıyı değiştirmek, kodunuzu düzenlemek anlamına gelir; çünkü sağlayıcının istemcisi programınızın içine entegre edilmiştir.

Meta-harness, her ikisinin bir seviye üzerinde yer alır. Harness'ları alt süreçler (child processes) olarak çalıştıran bir denetleyicidir. Omnigent, sağlayıcı CLI'ını başlatır, ona işi verir ve dönen sonucu okur. Hali hazırda kurduğunuz CLI'ı ve bunun için ödeme yaptığınız aboneliği veya API (application programming interface) anahtarını kullanmaya devam edersiniz. Tüm fark budur ve bu fark, aracın kimin için olduğunu belirler: halihazırda çalışan birden fazla ajan CLI'ına sahip olan ve bunları her seferinde tek bir terminal üzerinden yönetmekten yorulan kişiler için.

Bir orkestrasyon katmanı hangi sorunu çözer?

  • Tedarikçi değiştirme maliyeti tek satıra iner. Ajan tanımı harness ve model verilerini tutar; bu sayede bir rolü bir tedarikçiden diğerine taşımak, YAML dosyasında yapılacak bir düzenlemeden ibarettir, yeniden yazım gerektirmez.
  • İnceleme süreci tedarikçiler arası yapılabilir. Bir model tarafından oluşturulan fark (diff), farklı bir şirkete ait model tarafından okunabilir. Aynı aileden gelen iki model benzer kör noktalara sahip olma eğilimindedir; bu nedenle aynı tedarikçiden alınan ikinci bir görüş daha az değerlidir.
  • Politika tek bir merkezden yönetilir. Bütçe eşikleri ve onay istemleri ajan dosyasında tanımlanır ve altındaki tüm alt ajanlar için geçerli olur.
  • Oturum, herhangi bir araçtan daha uzun ömürlüdür. Tek bir transkript, birden fazla CLI tarafından yapılan işi kapsar; böylece dört farklı kaydırma geçmişini birleştirmek zorunda kalmadan neler olduğunu geriye dönük okuyabilirsiniz.

Bunun maliyeti, katmanın kendisidir. Omnigent içindeki her hata, artık sizinle eskiden tek başına çalışan bir ajan arasında duran bir engeldir. Alfa aşamasında bu, teorik değil, gerçek bir maliyettir.

Çoklu ajan altyapısının tekil ajan araçlarının neresinde konumlandığı

Henüz bir sunucuda tek bir ajan çalıştırmadıysanız, işe oradan başlayın. VPS üzerinde kodlama ajanı çalıştırma rehberimiz, tekil ajan senaryosunu uçtan uca ele almaktadır ve Omnigent, bu kurulumun halihazırda mevcut olduğunu varsayar. Self-hosted yapay zeka ajanları alanı, ajanların kendisini seçtiğiniz yerdir; eğer buradaki terminoloji sizin için yeniyse, ajanların nasıl çalıştığını öğrenmek daha doğru bir ilk duraktır.

Omnigent, bir bağlayıcı katmanından farklı bir eksendedir. Ajanlara kendi veri kaynaklarınıza erişim sağlama gibi çalışmalar, bir ajanın nelere ulaşabileceği ile ilgilidir. Omnigent ise hangi ajanın, hangi sırada ve hangi sınırlar dahilinde çalışacağı ile ilgilenir. Her ikisini aynı anda isteyebilirsiniz; bu iki kavram birbiriyle çakışmaz.

Kurulum öncesi gereksinimler

  • Python 3.12 veya daha yeni bir sürüm. Yayınlanan paket requires-python >= 3.12 gereksinimini belirtir.
  • Terminal araçları içerisinde çalıştığı için tmux.
  • Halihazırda kurulu ve oturum açılmış en az bir sağlayıcı CLI aracı.
  • Claude, Codex ve Pi araçları için npm içeren Node.js 22 veya daha yeni bir sürüm. Yükleyici, Node 22.10 veya daha yeni bir sürümü kontrol eder ve eksik olması durumunda uyarı verir. Omnigent'in kendisi Node gerektirmez: PyPI üzerindeki wheel paketi derlenmiş web varlıklarını içerir; Node yalnızca git üzerinden yapılan derlemelerde zorunlu bir gereksinimdir.

Ana geliştirme dalı yerine sabitlenmiş bir sürüm kurun

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --version 0.7.0

sh -s -- kısmı bir süsleme değildir. Bu kısım olmadan sh, --version ifadesini kendi seçeneği olarak okur ve yükleyici hiçbir şekilde çalışmaz. sh Bash olduğunda, Bash kendi sürümünü yazdırır ve başarıyla çıkar; bu nedenle hiçbir şey kurulmaz ve herhangi bir uyarı alınmaz. -s -- ile birlikte sh, betiği boru hattından (pipe) okur ve --version 0.7.0 parametresini yükleyiciye iletir. Birkaç haftada bir köklü değişiklikler (breaking changes) yayınlayan bir depoda, bu durum tekrarlanabilir bir sistem ile sürprizlerle dolu bir sistem arasındaki farktır.

0.7.0 sürümü 29 Ekim 2026 itibarıyla PyPI üzerinde yayınlanmaya devam etmektedir, ancak 13 Kasım 2026 tarihli en güncel sürüm 0.22.0'dır. Daha önceki 0.19.1 sürümü, yeni özellik içermeyen, güvenlik odaklı bir yamadır: eMudhra ara sertifika otoritesinin güvenliğinin ihlal edilmesinin ardından bağımlılıkları günceller ve proje ekibi yükseltme yapılmasını önermektedir. Önemli olan sürüm numarası değil, sabitleme işlemidir: test ettiğiniz sürümü sabitleyin ve yükseltme yapmadan önce sürüm notlarındaki köklü değişiklikleri okuyun. Ancak bir sürümü sabitlemiş olmak, güvenlik güncellemelerini atlamak için bir neden değildir; bu nedenle bir güvenlik güncellemesi yayınlandığında sürümünüzü güncelleyin.

Yükleyici, Astral'ın Python paket yöneticisi olan uv'yi kullanır ve eksik olması durumunda önce uv'yi kurmayı teklif eder. Eğer uv zaten yüklüyse betiği atlayın:

uv tool install --force --python 3.12 "omnigent==0.7.0"

Ekstralar da aynı kalıbı izler ve bayrak tekrarlanır: betik üzerinde --extra e2b --extra kubernetes veya uv ile "omnigent[e2b,kubernetes]". Betik, siz --no-databricks parametresini geçmediğiniz sürece databricks ekstrasını da ekler; yukarıdaki uv satırı ise paketi bu ekstra olmadan kurar. Git etiketinin v0.7.0, PyPI üzerindeki paket sürümünün ise 0.7.0 olduğuna dikkat edin.

uv, ikili dosyayı uv tool dir --bin komutunun bildirdiği dizine, genellikle ~/.local/bin konumuna yerleştirir ve yükleyici bu dizini kabuk profilinize eklemeyi teklif eder. Temiz bir kurulumdan hemen sonra komut bulunamıyorsa nedeni budur. Ne kurduğunuzu kontrol edin:

omni upgrade --check

Bu komut, kurulu sürümü yayınlanan en son sürümle karşılaştırır ve herhangi bir yükseltme olup olmadığını, yükseltme işlemini gerçekleştirmeden size bildirir. omni ve omnigent aynı programın iki farklı isim altındaki halidir.

Bir model sağlayıcısına yönlendirme yapın

omni setup

Sihirbaz, ortamınızda halihazırda mevcut olan kimlik bilgilerini arar ve eksik olanlar için sizden giriş yapmanızı ister. API anahtarlarını, sağlayıcı aboneliklerini, OpenRouter veya Ollama gibi ağ geçitlerini ve Databricks çalışma alanlarını yönetir. Eğer aynı makinede halihazırda Ollama ile yerel bir model sunucusu çalıştırıyorsanız, bir ağ geçidini buna yönlendirin; böylece trafik asla makinenin dışına çıkmaz.

Minimal bir çoklu ajan çalıştırması

Örnek ajanlar depoda yer almaktadır; bu nedenle main yerine kurduğunuz etiketle aynı olanı klonlayın.

git clone --depth 1 --branch v0.7.0 https://github.com/omnigent-ai/omnigent.git
cd omnigent
omnigent run examples/polly/

Polly, depo ile birlikte gelen çoklu ajan kodlama orkestratörüdür. Yapılandırması claude_code, codex, opencode, cursor, hermes ve pi adlı alt ajanları ve tüm bu süreci çalıştırmaya değer kılan bir kuralı tanımlar: inceleme, her zaman uygulayıcıdan farklı bir sağlayıcı tarafından yapılır. Polly kendisi kod yazmaz. Planlama yapar, hedefi iş öğelerine böler, her birini delege eder ve her bir farkı (diff) başka bir sağlayıcıdan bir incelemeciye yönlendirir.

Polly, herhangi bir delegasyon yapmadan önce makinede hangi alt ajan CLI'larının mevcut olduğunu görmek için bir ön kontrol çalıştırır. Yalnızca bir sağlayıcı CLI'ı yüklü olduğunda farkı teslim edecek kimse bulunmaz; bu nedenle çıktıyı değerlendirmeden önce en az iki tane kurun. Diğer örnek olan Debby, biri Claude diğeri GPT olmak üzere iki başlı bir tartışma ajanıdır:

omni debby

Bu, iki sağlayıcının da yapılandırıldığını doğrulamak için kısa bir yoldur, çünkü herhangi bir şey söyleyebilmesi için her ikisine de ihtiyaç duyar.

Alt-ajanlar araç olarak tanımlanır

Ajan dosyası YAML formatındadır. executor, harness, model ve kimlik doğrulama bilgilerini tanımlar. tools ise MCP (model context protocol) sunucularını, Python fonksiyonlarını ve alt-ajanları barındırır. Alt-ajan, type: agent ve kendine ait bir yürütücüye sahip bir araçtır; yukarıdaki tüm mekanizmanın temelinde bu yatar.

name: orchestrator
prompt: |
  You coordinate coding and review tasks.

executor:
  harness: claude-sdk
  model: databricks-claude-sonnet-4-6

tools:
  coder:
    type: agent
    prompt: Write and test code.
    executor:
      harness: claude-sdk
      model: databricks-claude-opus-4-7
  reviewer:
    type: agent
    prompt: Review proposed changes.
    executor:
      harness: claude-sdk
      model: databricks-claude-sonnet-4-6
omnigent run path/to/my_agent.yaml

Bu model kimlikleri projenin kendi docs/AGENT_YAML_SPEC.md örneğinden gelir ve Databricks tarafından barındırılan isimlerdir. harness ve model değerlerini, kendi sisteminizde omni setup ile yapılandırdığınız değerlerle değiştirin. Spesifikasyondaki diğer harness değerleri arasında antigravity, copilot, kimi ve qwen bulunur. main üzerindeki güncel spesifikasyon, herhangi bir Agent Client Protocol sunucusu için acp:<slug> değerini de belgeler; ancak v0.7.0 spesifikasyonunda bu yer almadığı için, kullanmadan önce sabitlenmiş sürümünüzde çalıştığını doğrulayın. Spesifikasyon ayrıca bir alt-ajan üzerinde pass_history: true kullanımını destekler; bu, üst konuşmayı alt-ajana aktarır. Bu işlem her delegasyonda token harcar, bu nedenle yalnızca kendisine verilen görevi yerine getirmesi gereken alt-ajanlar için bu özelliği kapalı tutun. prompt değeri çalışan en küçük değişikliği yapması talimatını veren bir yazılımcı, inceleme yapan kişiye okunabilir kısalıkta bir diff sunar; bu durum, her iki rol için seçtiğiniz modelden daha önemlidir.

Uzun süreli orkestrasyonun neden VPS üzerinde çalıştırılması gerektiği

Çoklu aracı (multi-agent) çalıştırma süreci iki dakikalık bir komut değildir. Planlama, yetkilendirme, paralel git çalışma ağaçlarını bekleme, gözden geçirme ve revize etme aşamaları vardır. Dizüstü bilgisayarın kapağını kapatmak tüm bu süreci sonlandırır. Bir VPS (sanal özel sunucu) sürekli çalışır ve ağ bağlantısını korur; böylece siz izlemiyorken de oturum devam eder.

omnigent server --background
omnigent server status

Sunucu, 6767 numaralı port üzerinde bir web kullanıcı arayüzü barındırır. omnigent server status bir örneğin çalışıp çalışmadığını raporlar, omnigent stop ise onu kapatır. v0.7.0 sürümü, omni server --background lehine omni server start komutunu kaldırmıştır; v0.9.0 sürümü ise bunu kullanımdan kaldırılmış bir takma ad olarak geri getirmiştir.

6767 numaralı portu genel bir adres üzerinde yayınlamayın. İki yöntem güvenlidir. Portu güvenlik duvarında kapalı tutun ve ssh -N -L 6767:localhost:6767 you@your-server ile SSH üzerinden yönlendirin, ardından kendi makinenizde http://localhost:6767 adresinden web arayüzünü açın. Alternatif olarak, ön tarafta TLS (taşıma katmanı güvenliği) sonlandırması yapın ve kimlik doğrulamasını etkinleştirin:

OMNIGENT_AUTH_ENABLED=1 omnigent server --background

Bunun güvenlik duvarı kısmı standart bir işlemdir ve bir VPS için ufw güvenlik duvarı temelleri konusunda ele alınmıştır. Eğer sunucu halihazırda birkaç Docker Compose uygulamasının önünde Traefik çalıştırıyorsa, Omnigent aynı modeldeki bir diğer servis olarak eklenebilir.

Konteyner dağıtımı için deponun deploy/docker/ dizini bir Compose kurulumu barındırır: ./bootstrap.sh gizli verileri .env içine işler, ardından docker compose up -d sunucuyu 6767 yerine 8000 numaralı portta başlatarak Omnigent ve Postgres'i ayağa kaldırır. OMNIGENT_PORT bu ana bilgisayar portunu değiştirir. Compose, DATABASE_URL değerini sizin yerinize hesaplar (diğer dağıtım hedeflerinde aynı değişken Postgres veya SQLite seçimini yapar) ve OMNIGENT_AUTH_ENABLED, konteynerler içinde varsayılan olarak 1 değerini alır; bu, dışarıdan erişilebilen her şey için doğru varsayılandır.

Boyutlandırma konusunda, dağıtım notları sunucunun boşta çalışma bellek kullanımını yaklaşık 275 MB RSS olarak belirtir ve Fly.io yapılandırması 1 GB'lık bir makineyi zorunlu tutar. Boştaki ölçüm yalnızca yönetici (supervisor) içindir; 1 GB ise ayrılmış makine belleğidir. Alt aracılar, os_env: inherit aracılığıyla sağlanan korumalı alan (sandbox) dahil olmak üzere, üst sürecin çalışma dizinini ve ortamını paylaşabilir. Ayrı git çalışma ağaçları bir orkestrasyon tercihidir, bu nedenle sunucuyu aynı anda çalıştırdığınız araç takımlarına ve aracılara göre boyutlandırın. Sunucu ayağa kalktıktan sonra, omnigent login https://your-host ve ardından omnigent host https://your-host komutları dizüstü bilgisayarınızı sunucuya kaydeder ve omnigent attach <session_id>, çalışan bir oturumu başka bir cihazdan devralmanızı sağlar.

Uzaklaşmadan önce her alt ajanı korumalı alana (sandbox) alın

Omnigent, Omnibox adında işletim sistemi seviyesinde bir korumalı alan mekanizması ile gelir. Linux üzerinde bubblewrap isim alanlarını ve seccomp kurallarını kullanır; bu sayede sınırları ajanın komutları değil, çekirdek (kernel) zorunlu kılar. Komut enjeksiyonuna uğramış bir ajan, çekirdek kurallarını aşamaz. Öncelikle bağımlılığı yükleyin:

sudo apt install bubblewrap

Yapılandırma, ajan dosyasındaki os_env altında yer alır:

os_env:
  type: caller_process
  cwd: .
  sandbox:
    type: linux_bwrap
    write_paths: [.]
    write_files: []
    read_paths: []
    allow_network: true
    cwd_allow_hidden: [.venv]
    env_passthrough: []
    egress_rules: []
    credential_proxy: []

Çalışma dizini, write_paths içinde listelenmediği sürece salt okunurdur; bu sayede hatalı bir ajan çalışma alanı dışına yazamaz. Çalışma dizini altındaki üst seviye nokta ile başlayan dosyalar (dotfiles) ve her bir read_paths kök dizini, cwd_allow_hidden içinde belirtilmedikçe gizli kalır. Bu, geniş bir okuma izninin üst seviye .ssh veya .aws dizinlerini sessizce ifşa etmeyeceği anlamına gelir. İç içe geçmiş nokta ile başlayan dosyalar varsayılan olarak görünür kalır; bunları ağaç genelinde gizlemek için cwd_hidden_scan_recursive: true ayarını kullanın. egress_rules ayarını yaptığınızda tüm HTTP ve HTTPS trafiği varsayılan olarak reddeden bir proxy üzerinden geçer; her kural "METHODS host/path-glob" olarak yazılır. credential_proxy bir adım daha ileri gider: ajan yalnızca bir yer tutucu (placeholder) barındırır ve istek dışarı çıkarken proxy gerçek gizli bilgiyi (secret) yerleştirir; böylece sızdırılan bir transkript kullanılabilir hiçbir veri içermez. Çoklu donanım (multi-harness) kurulumunda her alt ajan, agents/ altındaki kendi yapılandırma dosyasında kendi korumalı alan bloğunu taşır; bu sayede bir incelemecinin ağ erişimi engellenirken uygulayıcının erişimi korunabilir.

Sınır belgelerde belirtilmiştir ve bu önemlidir. İşletim sistemi korumalı alanı, sys_os_* araç çağrıları ve terminaller için geçerlidir. MCP sunucularını ve Omnigent denetleyici sürecinin kendisini kapsamaz. Başlattığınız bir MCP sunucusu, sizin izinlerinizle korumalı alanın dışında çalışır. Bu boşluk, daha güçlü yöntemin hala ajan başına bir adet tek kullanımlık makine kullanmak olmasının nedenidir; bu konu kodlama ajanlarını tek kullanımlık bir sanal makinede çalıştırma başlığında ele alınmıştır. İşin diğer yarısı kimlik bilgileridir ve gizli bilgileri ajanın erişiminden uzak tutma konusu, altı alt ajan tek bir ana makineyi paylaştığında daha da zorlaşır.

Harcama eşikleri, aynı dosyada tanımlanan politikalardır:

policies:
  budget:
    type: function
    handler: omnigent.policies.builtins.cost.cost_budget
    factory_params:
      max_cost_usd: 5.00
      ask_thresholds_usd: [1.00, 3.00]

cost_budget politikası, yumuşak eşiklerde onay ister ve varsayılan olarak max_cost_usd seviyesinde tüm modelleri engeller. Boş olmayan bir expensive_models listesi tanımlamak, sınırı bir düşürme (downgrade) kapısına dönüştürür: bu liste dışındaki modeller harcama yapmaya devam edebilir. Bir tedarikçiyle planlama yapan, ikincisiyle uygulayan ve üçüncüsüyle inceleme yapan bir süreç aynı anda üç farklı yerde harcama yapar; bu nedenle eşikleri ilk faturadan sonra değil, ilk gözetimsiz çalıştırmadan önce ayarlayın. Yerleşik özellikler arasında ayrıca max_tool_calls_per_session ve ask_on_os_tools bulunur; bunlar dosya ve kabuk işlemleri öncesinde onay ister. Yapay zeka ajanı maliyetlerini bir VPS üzerinde kontrol altında tutma hakkındaki notlarımız burada doğrudan geçerlidir ve paralel alt ajanlar harcama hızını katladığı için daha da kritik bir öneme sahiptir.

Bu depo ne kadar hızlı güncelleniyor?

GrafikDays between tagged Omnigent releases, v0.2.0 to v0.7.0
Bu grafiğin arkasındaki veriler
[
  {
    "version": "v0.2.0",
    "released": "2026-06-19",
    "interval": 3
  },
  {
    "version": "v0.3.0",
    "released": "2026-06-27",
    "interval": 8
  },
  {
    "version": "v0.4.0",
    "released": "2026-07-03",
    "interval": 6
  },
  {
    "version": "v0.5.0",
    "released": "2026-07-10",
    "interval": 7
  },
  {
    "version": "v0.5.1",
    "released": "2026-07-10",
    "interval": 0
  },
  {
    "version": "v0.6.0",
    "released": "2026-07-21",
    "interval": 11
  },
  {
    "version": "v0.7.0",
    "released": "2026-07-27",
    "interval": 6
  }
]

Bunlar, 3 Ağustos 2026 tarihinde projenin kendi sürüm sayfasından alınan yayınlanma tarihleridir. 2026-06-19 ile 2026-07-27 tarihleri arasında 7 adet etiketli sürüm yayınlanmış olup, herhangi iki sürüm arasındaki en uzun boşluk 11 gündür. v0.5.1 sürümü, kendisinden önceki sürümle aynı gün yayınlanmıştır. 13 Haziran 2026 tarihli 0.1.0 ve 16 Haziran 2026 tarihli 0.1.1 sürümleri, GitHub sürüm sayfasında yer almadığı için grafiğe dahil edilmemiştir; v0.2.0 için gösterilen üç günlük süre 0.1.1 sürümünden itibaren hesaplanmıştır.

Bu sürümlerden ikisi, kılavuzlarda halihazırda belgelenmiş olan komutları değiştirmiştir. v0.7.0 sürümü, omni server start komutunu kaldırarak yerine omni server --background komutunu getirmiştir. v0.6.0 sürümü, omnigent[memory] eklentisini omnigent[hindsight] olarak yeniden adlandırmış, ancak memory ifadesini 0.10.0 sürümüne kadar çalışan bir uyumluluk takma adı olarak tutmuştur. 25 Ağustos 2026 tarihinde yayınlanan 0.11.0 sürümü ile birlikte bu takma ad kaldırılmıştır; bu nedenle Haziran ayında yazılmış bir belgeden kopyalanan kurulum satırı artık Hindsight istemcisini yüklememektedir. Kurulum komutunuzda --version kullanmanızın ve git clone dosyanızda bir etiket belirtmenizin nedeni bir stil tercihi değil, bu durumdur.

Gelişim hızı bu tarihten sonra da yavaşlamamıştır. 29 Ekim 2026 itibarıyla PyPI üzerinde, 28 Ekim'de yayınlanan 0.20.0 sürümü listelenmektedir. Bu, 0.7.0 sürümünden sonra gelen on üçüncü ara sürümdür ve projenin sürüm notları bunların birçoğunda geriye dönük uyumluluğu bozan değişiklikler yapıldığını belirtmektedir. Bu sayfadan kopyalanan içerikler için iki değişiklik önemlidir: v0.12.0 sürümü ile birlikte, parametresiz omni komutu Polly ajanı yerine arka plan sunucusunu başlatacak şekilde değiştirilmiştir (omni run artık varsayılan ajanı başlatmaktadır) ve v0.13.0 sürümü, yönetilen terminaller için tmux 3.3 veya daha yeni bir sürüm gerektirmektedir.

Henüz güvenilmemesi gereken durumlar

27 Ekim 2026 itibarıyla depo yaklaşık 11 bin yıldıza, 1,8 bin çatal (fork) sayısına ve kabaca 910 açık soruna sahiptir; ilk genel sürümü ise dört aydan biraz daha uzun bir süre önce yayınlanmıştır. Yıldızlar ilgiyi ölçer, ilgi ise olgunluk demek değildir. Proje kendisini alfa olarak tanımlamaktadır ve yukarıdaki sürüm geçmişi bunun gerçekten alfa aşaması olduğunu göstermektedir.

  • Üretim ortamına ait kimlik bilgilerini barındıran bir sunucuda çalıştırmazdım; çünkü sandbox, MCP sunucularını veya denetleyiciyi (supervisor) kapsamamaktadır.
  • Bir cost_budget politikası olmadan çalışır durumdaki bir süreci gözetimsiz bırakmazdım; çünkü üç farklı sağlayıcı aynı anda faturalandırma yapabilir. Boş olmayan bir expensive_models listesi ile harcamalar daha ucuz modeller üzerinden devam edebilir.
  • OMNIGENT_AUTH_ENABLED ayarı yapılmadan ve önünde TLS olmadan sunucuyu genel bir IP adresine açmazdım.
  • Ajan YAML yapılandırmasını henüz ara sürümler arasında kararlı kabul etmezdim; bu nedenle sürümü sabitleyin ve yükseltme yapmadan önce sürüm notlarını okuyun.

Sizi şaşırtmadan önce bilmeniz gereken bir diğer konu şudur: v0.6.0 sürümü ile anonimleştirilmiş kullanım telemetrisi eklenmiştir. README dosyası bunun varsayılan olarak toplandığını belirtmektedir ve proje, bu verilerin nasıl devre dışı bırakılacağı da dahil olmak üzere tüm detayları özel bir telemetri sayfasında belgelemektedir. Eğer makine müşteri işleri için kullanılıyorsa, o sayfayı okuyun ve kararınızı bilinçli bir şekilde verin.

Omnigent'in bugün gerçekten iyi olduğu alan, inşa edilme amacı olan konudur. Elinizde üç veya dört adet ajan CLI aracı varsa, zaten bunlar için ödeme yapıyorsanız ve bunlardan birinin yazarken diğerinin inceleme yapmasını istiyorsanız, bu şu an tek bir makinede ve Linux üzerinde gerçek sandbox desteğiyle çalışmaktadır. Bunun ötesindeki her şeyi umut verici ancak tamamlanmamış olarak değerlendirin.

FAQ

Omnigent bir ajan mıdır, yoksa ajanları çalıştıran bir yapı mıdır?

Ajanları çalıştırır. Omnigent bir meta-harness yapısıdır: Claude Code, Codex veya OpenCode gibi halihazırda kurulu olan satıcı CLI araçlarını başlatır, her birine görev atar ve sonuçları tek bir oturumda denetler. Kendine ait bir modeli yoktur. Bu yönüyle, Python ile bir kütüphane üzerinden kod yazıp kendi programınızı ajan haline getirdiğiniz çerçeve (framework) yapılarından ayrılır.

Omnigent'in işe yaraması için Claude Code ve Codex'in kurulu olması gerekir mi?

En az bir satıcı CLI aracının kurulu ve oturum açmış olması gerekir; çünkü Omnigent bu programların yerine geçmek yerine onları yönetir. İçerisinde gelen Polly örneğini kullanmak için farklı satıcılardan iki veya daha fazla araca ihtiyacınız vardır. Polly kuralına göre inceleme işlemi, her zaman uygulamayı yapan satıcıdan farklı bir satıcı tarafından gerçekleştirilir; bu nedenle tek bir CLI mevcut olduğunda diff dosyasının gönderileceği ikinci bir satıcı bulunmaz.

En güncel sürüm yerine belirli bir Omnigent sürümünü nasıl kurarım?

--version değerini sh -s -- ile kurulum betiğine iletin; örneğin sh -s -- --version 0.7.0 komutundaki gibi. -s -- kullanılmadığında sh, --version değerini kendi seçeneği olarak algılar ve kurulum çalışmaz: örneğin Bash kendi sürümünü yazdırıp çıkar. uv halihazırda yüklüyse uv tool install --force --python 3.12 "omnigent==0.7.0" aynı işi görür. Git etiketi v0.7.0 iken, PyPI sürüm dizgisi 0.7.0 şeklindedir.

Omnibox sandbox, ajanları gözetimsiz çalıştırmak için yeterli midir?

Kapsadığı alanlar için güçlüdür ve neleri kapsamadığı konusunda nettir. Linux üzerinde bubblewrap ve seccomp kullanır; bu sayede çekirdek dosya ve ağ sınırlarını zorunlu kılar ve ajan bu sınırların dışına çıkamaz. Dokümantasyon, bu korumanın sys_os_* araç çağrıları ve terminaller için geçerli olduğunu, MCP sunucularını veya Omnigent denetleyici sürecini kapsamadığını belirtir. Dolayısıyla bir MCP sunucusu normal izinlerinizle çalışır; bu yüzden gözetimsiz işlemler için ajan başına tek kullanımlık bir sanal makine kullanmak daha güçlü bir izolasyon sağlar.

Bir VPS üzerinde Omnigent sunucusu ne kadar bellek gerektirir?

Projenin dağıtım notları boşta yaklaşık 275 MB RSS tüketimi bildirmektedir ve Fly.io yapılandırması 1 GB'lık bir makine tahsis etmektedir. Boşta yapılan bu ölçüm yalnızca sunucuyu kapsar, alt ajanları içermez. Alt ajanlar, os_env: inherit aracılığıyla sandbox dahil olmak üzere ana sürecin çalışma dizinini ve ortamını paylaşabilir; ayrı çalışma kopyalarının olacağı garanti edilmez. Polly tarzı çalıştırmalar paralel git worktree yapılarını kullanır, bu nedenle RAM ve disk boyutunu sunucu için değil, aynı anda çalıştırmayı planladığınız ajan sayısına göre belirleyin.

Bu yazı işinize yaradı mı?