Kılavuz
Yapay Zeka
Omarchy, sizin için bir varsayılan seçmeden aşağıdaki kodlama ajanlarının başlatıcılarını içerir. İlk kullanımda CLI’sini kurmak için bir komut çalıştırın, ardından istendiğinde kimlik doğrulaması yapın. Hermes istisnadır: ilk kullanımda onun için hiçbir şey kurulmaz ve onu seçmek, aşağıda Masaüstü uygulamaları bölümünün açıkladığı gibi Hermes Desktop’ı kurar.
| Komut | Ajan |
|---|---|
claude |
Claude Code |
codex |
OpenAI Codex |
opencode |
OpenCode |
agy |
Google Antigravity CLI |
amp |
Amp |
commandcode |
Command Code |
copilot |
GitHub Copilot CLI |
crush |
Crush |
cursor-agent |
Cursor CLI |
devin |
Cognition’dan Devin CLI |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuff’ın ücretsiz, reklam destekli kodlama ajanı |
grok |
xAI’dan Grok Build |
hermes |
Hermes, Nous Research’ün ajanı |
kilo |
Kilo, OpenCode tabanlı bir kodlama ajanı |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMax’in kodlama ajanı |
muse |
Muse Code, Meta’nın kodlama ajanı |
omp |
Oh My Pi |
ori |
Ori, OpenRouter’ın harness’ı |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, Alibaba’nın kodlama ajanı |
ori aralarında tuhaf olanıdır: diğer harness’ları OpenRouter’ın tüm model kataloğuna karşı çalıştırır, yani ori claude, ori codex veya ori opencode bu ajanları işaret ettiğiniz model üzerinde başlatır ve ori code Ori’nin kendi ajanıdır.
Ajanları kurma ve güncelleme
Hermes dışında, bu ajanlar mise’nin tembel kurulumunu kullanır: ilk başlatma CLI’yi kurar ve sonraki başlatmalar onu yeniden kullanır. mise ayrıca kurulu bir ajanı, başlamadan hemen önce veya kabuk isteminde arka planda, en fazla dört saatte bir yeni bir sürüm için kontrol eder. Bu güncelleme başarısız olursa veya çevrimdışıysanız, kurulu sürüm çalışır. omarchy update, kurulu ajanları Omarchy’nin geri kalanıyla birlikte günceller ve mup yalnızca mise tarafından yönetilen araçları günceller.
Bir ajanın kendi güncelleyicisi, örneğin claude update, codex update veya bir uygulamadaki güncelleme düğmesi, mise tarafından yönetilen kurulumu güncellemez. codex update başarısız olur ve claude update, mise’nin izlemediği ayrı bir kopya kurarken başarı bildirebilir. Bir ajanın kendi yükleyicisini ve güncelleyicisini kullanmayı tercih ederseniz, onu disable_tools listesine ekleyin; bkz. Önceden kurulu CLI araçları.
Yapılandırılmış tüm tembel araçları ihtiyacınız olmadan önce kurmak için mise install --include-lazy komutunu çalıştırın. Bu, ajanların yanı sıra Omarchy’nin diğer varsayılan CLI araçlarını da içerir. Tek bir aracı kurma veya kendi kurulumunuzu kullanma hakkında bkz. Önceden kurulu CLI araçları.
grok, claude ve codex ile aynı şekilde, mise’nin birinci taraf grok paketi aracılığıyla kurulur. grok komutunu çalıştırın veya onu Setup > Defaults > Agent altında seçin. x.ai üzerindeki curl | bash yükleyicisini atlayın. Bu yol, ~/.grok/bin içine ikinci bir kopya yerleştirir, onu PATH üzerinde öne ekler ve Omarchy’nin sarmalayıcısının üzerine yazar.
dsh, tarayıcı arayüzünü 127.0.0.1:3080 üzerinde açar ve başlatma dizinini varsayılan çalışma alanı olarak kullanır. Tarayıcı arayüzü bir başlangıç istemi almaz, bu nedenle omarchy agent prompt onu istem panonuzda olacak şekilde açar, böylece yapıştırabilirsiniz. Omarchy onu DeepSeek’in onay gerektirmeyen izin ön ayarıyla başlatır. DeepSeek Harness, resmi model API’sini kullandığınızda oturum günlüklerini DeepSeek’e yükler; bunu tarayıcı arayüzünde Settings > General > Upload Session Log altında kapatın. Ona gönderdiğiniz geri bildirimler de oturumla birlikte yüklenir, tabii onu DSH_TELEMETRY_MODE=DISABLED ile başlatmazsanız.
Varsayılan ajan
Varsayılan ajanınızı omarchy default agent <name> ile veya Omarchy Menu’de (Super + Space) Setup > Defaults > Agent altında seçin. Ajan henüz kurulu değilse, onu seçmek önce onu kurar. Yeni bir Omarchy, tek seferlik bir bildirimle sizi bu seçimi yapmaya davet edecektir.
Claude’u seçmek, Chromium, Chrome, Brave, Brave Origin ve Edge için tarayıcı uzantısını kurmayı da dener. Uzantı kurulumu tüm kullanıcılar için geçerlidir ve sistem parolanızı isteyebilir; uzantı kurulumunu iptal etmek veya kurulumun başarısız olması yine de Claude’u seçer ve başlatır. Tarayıcınızı yeniden başlatın, istenirse uzantıyı etkinleştirin ve bağlamayı tamamlamak için Claude’da oturum açın. Bağlantıyı kontrol etmek için Claude’da /chrome komutunu çalıştırın. Firefox ve Zen bu uzantıyı desteklemez. Bu kurulum eklenmeden önce Claude zaten varsayılanınızsa, uzantıyı kurmak için onu tekrar seçin.
Seçiminizi yaptıktan sonra, Super + Shift + Ctrl + A varsayılan ajanı özel bir terminal penceresinde başlatır (veya henüz seçim yapmadıysanız seçiciyi açar). Onu doğrudan bir göreve de başlatabilirsiniz: omarchy agent prompt "Review this project". Freebuff ve DeepSeek Harness bir başlangıç istemi almaz, bu nedenle bunun yerine istem panonuzda olacak şekilde açılırlar, böylece yapıştırabilirsiniz. Bu şekilde başlatılan ajanlar, kendi durup sormayan modlarında gözetimsiz çalışır, bu yüzden gerçekten bir şeyler yapmalarına hazır olun! MiniMax Code’un etkileşimli oturumları için böyle bir modu yoktur, bu nedenle izinleri her zamanki gibi sorar. Ayrıca ajanlar ana dizininiz için güveni hatırlamayı reddettiğinden, $HOME konumundan başlatmalar bunun yerine ~/Work içinde başlar.
Terminal kısayolları da vardır: a varsayılan ajanı geçerli terminalde satır içi çalıştırır, c, cx ve cy ise OpenCode, Claude Code ve Codex’i doğrudan başlatır (yine otomatik onaylayan modlarında). Tema değişiklikleri de ajanlara senkronize olur: Claude Code, Pi, OpenCode ve Hermes (Omarchy onu kurduktan sonra) Omarchy temasını değiştirdiğinizde sizinle birlikte değişir.
Ajanlar paneli
Üst çubukta bir ajanlar simgesi vardır. Henüz bir ajan kurmadıysanız, paneli Claude, Codex veya Grok’ta oturum açmanızda size yol gösterir ve bunlardan ilki varsayılan ajanınız olur. Bundan sonra, panel her aboneliği tek bir sayfada toplar: her ajan ve hesap, planıyla birlikte, 5 saatlik oturum ve haftalık limitlerinin her biri için sıfırlanmasına kalan süreyle birlikte bir gösterge (tam yüzde için üzerine gelin) veya kalan ön ödemeli bakiye, hepsi de tümünde kullandıklarınız arasında dönen bir satırın altında, örneğin bu haftaki tokenlar ve en çok kullandığınız model gibi. Make something altında, görevi varsayılan ajanınıza devreden yeni bir tema, eklenti veya uygulama için başlangıç istemleri sunar. Uygulamalar, Omarchy’nin kendi Hype, Monologue ve Omacut uygulamalarının yapıldığı şekilde, C++ ve Qt Quick ile, omarchy-app ajan becerisini izleyerek oluşturulur ve ihtiyaç duydukları derleyici ile Qt parçaları kurulu olarak gelir. Claude Code, Codex, Grok, Kimi, Cursor ve onun Grok Bot hakkı, GitHub Copilot, Muse, Antigravity, Kimchi ve Devin, limitleriyle birlikte kutudan çıkar çıkmaz kapsanır ve Hermes, Mistral Vibe ve Qwen Code, onları kullandıktan sonra oturumlarını ve tokenlarını gösterir. pi, omp veya opencode aracılığıyla kullandığınız sağlayıcı planları ve anahtarları da görünür: OpenCode Zen ve Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan ve Synthetic, limitleriyle birlikte; Fireworks, OpenRouter ve DeepSeek, ön ödemeli bakiyeleriyle birlikte; ve kendi donanımınızda çalıştırdığınız modeller Local models altında. Her ajan, onu kaç harness aracılığıyla kullanırsanız kullanın, faturayı kim kesiyorsa onun altında bir kez sayılır.
Panel için çubuk simgesine sol tıklayın, varsayılan ajanınızı başlatmak için sağ tıklayın. Arkasındaki kullanım kayıtları, omarchy agent usage-update tarafından her 15 dakikada bir yeniden oluşturulur ve panel, senkronize edilmiş bir klasör aracılığıyla diğer makinelerinizdeki kullanımı bile birleştirebilir. Tüm ayarlar için $OMARCHY_PATH/shell/plugins/agents/ altındaki README’ye bakın.
Birden fazla abonelik
Birden fazla Claude, Codex veya Grok planı için ödeme yapıyorsanız - örneğin kişisel bir Max ve bir iş planı - Omarchy hepsini oturum açık tutabilir ve aralarında geçiş yapabilir. Bir aboneliği ajanlar panelindeki + ile ekleyin; bu size tam orada yol gösterir, veya omarchy agent account add claude Work ile ekleyin (veya codex, veya grok). Eksikse CLI’yi kurar. Bir sağlayıcı için ilk hesap, CLI’nin her zaman baktığı yerde, normal tarayıcınız üzerinden oturum açar. Bundan sonraki her hesap özel bir pencere üzerinden oturum açar, böylece tarayıcınızda zaten oturum açmış olduğunuz hesap yanlışlıkla alınmaz; orada eklediğiniz hesap olarak oturum açın ve önceden açık olan özel pencereleri önce kapatın. Bunu yapmak için asla CLI’den çıkış yapmayın: çıkış yapmak kayıtlı oturumu iptal eder ve o hesabın tekrar eklenmesi gerekir.
Abonelik girişlerinizi SSH üzerinden başka bir Omarchy makinesine kopyalamak için omarchy agent account copy user@laptop komutunu çalıştırın. Gönderici, hedefte kurulu bir alıcı olmadığında geçici bir alıcı sağlar, böylece eski Omarchy makineleri bir güncelleme olmadan hesapları alabilir. Kurulu alıcılar önceliklidir. Bu, tüm Claude, Codex ve Grok aboneliklerini kopyalar; onları seçmek için sağlayıcı adlarını ekleyin, örneğin omarchy agent account copy laptop claude. Hesap adları ve komut kimlikleri, hedefte zaten mevcut olan hesaplar da dahil olmak üzere kaynakla eşleşir. İlgisiz hedef hesapları, adları çakışırsa sayısal bir sonek alır ve ayarlar, beceriler, eklentiler ve konuşma geçmişi her makinede yerel kalır.
Mevcut hedef kimlik bilgileri korunur. Kaynakta orada zaten oturum açılmış bir hesap varsa, adı kimlik bilgileri değiştirilmeden senkronize edilir; diğer hesaplar onun yanına eklenir. Eşleşen hesaplar için kayıtlı kimlik bilgilerini değiştirmek üzere, hedefte o hesabın oturumlarından çıktıktan sonra omarchy agent account copy --replace laptop claude komutunu kullanın. Yeni bir hedef, kaynağın aktif hesabını ve geçiş tercihlerini de alır; yerleşik bir hedef kendininkileri korur.
Kimlik bilgileri SSH üzerinden seyahat eder ve hedefte özel dosyalarda saklanır, bu nedenle yalnızca güvendiğiniz makinelere kopyalayın. Bu tek seferlik bir kopyadır, sürekli senkronizasyon değildir. Codex yenileme tokenları başka bir makine tarafından döndürülebilir ve kopyalanmış bir girişi yenilenmeye muhtaç bırakabilir; birkaç makinede eşzamanlı kullanım için ayrı oturum açmalar en güvenilir seçim olmaya devam eder. Bkz. Codex’in hesap kimlik doğrulama kılavuzu.
Sağlayıcı başına bir hesap aktiftir ve her yeni oturum onunla başlar: cx, cy, düz bir claude, codex veya grok, omarchy agent aracılığıyla başlatılan her şey ve CLI’yi PATH üzerinde bulan betikler veya editörler. omarchy agent account use work ile geçiş yapın (ve omarchy agent account use main ile geri dönün), veya panelde bir hesabın numarasına basıp ardından Enter tuşuna basarak (veya Use düğmesine tıklayarak). Zaten çalışan oturumlar, başladıkları hesapta kalır. Konuşma geçmişi, ayarlar, beceriler ve eklentiler hesaplar arasında paylaşılır, bu nedenle aynı klasörde claude --continue, yeni hesapta kaldığınız yerden devam eder.
Birden fazla hesabınız olduğunda, panel her hesabın limitlerini yan yana gösterir ve aktif olanı işaretler. Varsayılan olarak Omarchy, aktif hesap bir limitin %95’ini geçtiğinde sizi bilgilendirir ve bildirime tıklamak en çok boş alanı olan hesaba geçer. Bir hesabı kendi kendine değiştirmesi için, panelde hesabın satırının üzerine gelip Use’un yanında görünen Autoswitch’e tıklayın (veya m tuşuna basın), veya omarchy agent account mode auto komutunu çalıştırın; açıkken Autoswitch, Use’un yerini alır ve ona tekrar tıklamak bilgilendirmeye geri döner. Eşiği değiştirmek için bir sayı ekleyin, örneğin omarchy agent account mode auto 90. Her hesap eşiğin üzerindeyse, hangi hesabın ilk boşalacağıyla birlikte bir kez haber alırsınız. Aktif bir hesap eşiğine 15 puan yakınken (varsayılanda %80), limitleri 15 dakikada bir yerine üç dakikada bir kontrol edilir.
omarchy agent account list her hesabı ve en son limitlerini gösterir, omarchy agent account remove work birini unutur ve omarchy agent account rename primary Hey birini yeniden adlandırır (veya panelde bir hesabın adına tıklayın). Bu komutlar varsayılan ajanınızın hesapları üzerinde çalışır; diğer sağlayıcıya ulaşmak için önce onu adlandırın, örneğin omarchy agent account use codex side. ~/.claude veya ~/.codex içinde zaten sahip olduğunuz giriş, Main hesabıdır ve olduğu yerde kalır. Yaklaşık sekiz saatten fazla kullanılmadan bırakılan bir hesap Sign-in required gösterebilir; panelde tam orada o hesabı tekrar oturum açmak için ona tıklayın veya içinde bir oturum başlatın; bu, oturumu kendi kendine yeniler. Bir hesap eklenirken sahip olduğunuz MCP sunucuları ona da gelir, ancak daha sonra claude mcp add ile ekledikleriniz yalnızca onları eklediğiniz hesaba ulaşır. Claude Desktop ve bir CLI ikili dosyasına mutlak bir yolla yapılandırılmış araçlar geçişi izlemez. Açık bir CLAUDE_CONFIG_DIR, CODEX_HOME veya GROK_HOME, seçili hesaba göre önceliklidir.
Çökme tanılama
Omarchy, süreç çökmeleri için systemd-coredump’ı izler. Bir şey segfault yaptığında, bir “Process crashed” bildirimi alırsınız - ona tıklayın ve çökme, varsayılan ajanınıza Omarchy’nin diagnose-crash becerisiyle birlikte devredilir; bu beceri, ajanı çekirdek dökümünden gerçekleri tespit etme ve çökmenin yukarı akışa bildirilmeye değer olup olmadığına karar verme konusunda yönlendirir. Onu coredumpctl list çıktısındaki herhangi bir PID’ye karşı omarchy agent crash <pid> ile elle de çalıştırabilirsiniz.
İzleme varsayılan olarak açıktır. Onu Trigger > Toggle > Crash Capture altında (veya omarchy toggle crash-capture ile) kapatın ve bildirimler durur; omarchy agent crash <pid> elle çalışmaya devam eder.
Çökmeler ayrıca tek tek programlar için susturulabilir; tanılama sonunda size bunu sunar. omarchy crash mute hyprland yalnızca o program için bildirimleri durdurur, omarchy crash mute hyprland off onları geri getirir ve omarchy crash mute tek başına neyi susturduğunuzu listeler. İkili dosyanın yolunu da adı kadar memnuniyetle alır, yani omarchy crash mute /usr/bin/hyprland aynı şeyi yapar. İçinde boşluk olan bir adı tırnak içine alın, örneğin omarchy crash mute 'Some App'. Diğer her şey bildirmeye devam eder ve susturulan program yine çöker - bu hatırlatıcıyı gizler, hiçbir şeyi düzeltmez.
Masaüstü uygulamaları
Install > AI menüsü ayrıca birkaç grafiksel yapay zeka uygulaması taşır: ChatGPT masaüstü uygulaması, Claude masaüstü uygulaması (Anthropic’in Chat, Cowork ve Claude Code sekmeleri içeren Linux betası), xAI’nin modelleriyle sohbet etmek için Grok Bot, Hermes Desktop, OpenClaw, Perplexity masaüstü uygulaması ve T3 Code. Grok Bot masaüstü sohbet uygulamasıdır. Kodlama ajanı grok komutudur.
Hermes Desktop bilinmesi gerekenidir, çünkü bir makinede tek bir Hermes vardır ve o da uygulamanındır: Hermes yalnızca uygulama aracılığıyla kurulur ve varsayılan ajanın çalıştırdığı hermes komutu uygulamanındır. Hermes’i varsayılan ajan olarak seçmek, Install > AI girdisinin yaptığı şeyin aynısını kurar: paketi ve Hermes’in kendi yükleyicisi tarafından kurulan, ilk seferde birkaç dakika süren ~/.hermes altında bir Hermes çalışma zamanı. Bu çalışma zamanı, terminaldeki hermes komutunun, varsayılan ajanın ve uygulamanın hepsinin kullandığı tek Hermes’tir ve bir Omarchy sürümünü beklemek yerine hermes update ile kendini günceller. Onu kurmak ayrıca Hermes’e Omarchy temasını omarchy adlı bir dış görünüm olarak verir; her Hermes yüzeyi siz tema değiştirdikçe onu izler; istemezseniz Hermes’in Appearance ayarlarında veya /skin ile başka bir tane seçin ve Omarchy bu seçimi rahat bırakır. Uygulamayı Remove > AI altında kaldırmak önce Hermes’i kapatır, gateway dahil, o çalışma zamanını da onunla birlikte götürür ve siz aksini söylemedikçe sohbetlerinizi, anılarınızı ve Hermes’in kendisi için yazdığı becerileri korur: bu verilerin ve bağlantı ayarlarınızın da gitmesi gerekip gerekmediğini sorar, varsayılan hayırdır.
OpenClaw’un masaüstü deneyimi, kendi yerel gateway’i tarafından desteklenen bir web uygulaması olarak açılan Control UI’sıdır. OpenClaw ~/.openclaw içinde yaşar ve kendini günceller: Control UI’nin “Update Gateway” düğmesini kullanın veya openclaw update komutunu çalıştırın; gateway yeni sürümde yeniden başlar. Omarchy yalnızca yeni bir kurulumun hangi sürümden başlayacağını seçer. OpenClaw’u Remove > AI altında kaldırmak gateway hizmetini ve uygulamayı onunla birlikte götürür ve ardından ~/.openclaw dizininin de gitmesi gerekip gerekmediğini sorar, çünkü burası sohbetlerinizi ve kimlik bilgilerinizi OpenClaw’un kendisi ve indirdiği eklenti çalışma zamanlarıyla birlikte tutar; varsayılan onu korur ve OpenClaw’u tekrar kurmak onu geri alır.
T3 Code, bir paketten ziyade ~/.local/share/t3code içindeki resmi AppImage sürümünden çalışır, bu nedenle kendini günceller. Onu kurmak, Stable veya Nightly kanalında mı başlayacağını sorar; daha sonra T3 Code’un ayarlarından değiştirin. Konularınız ve ayarlarınız ~/.t3 içinde yaşar ve T3 Code’u Remove > AI altında kaldırmak onları da onunla birlikte götürür.
Yerel LLM’ler
Omarchy, yerel LLM modellerini çalıştırmanın iki yolunu önerir: LM Studio ve Ollama. LM Studio, açık ağırlıklı modelleri bulmak, kurmak ve çalıştırmak için bir GUI arayüzü sağlar. Kolayca başlamak için harika bir yoldur. Ollama da benzer şekilde yapmak için bir CLI sunar. Ancak yerel modellerde yeniyseniz, LM Studio ile başlardım. İkisini de Omarchy Menu’de Install > AI altında kurabilirsiniz.
Omarchy Becerisi
Ajan becerileri, yapay zekanın belirli araçları belirli bir şekilde kullanmasına yardımcı olur ve Omarchy, sistemi uyarlamak için varsayılan bir beceriyle birlikte gelir. Hyprland yapılandırmanızı ince ayarlamak, çubuğu ayarlamak veya hatta sıfırdan yeni bir tema oluşturmak gibi. Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills ve her ~/.hermes/profiles/*/skills) ve genel ~/.agents/skills konumu için beceri dizinlerine sembolik olarak bağlanmıştır, bu nedenle çoğu harness onu otomatik olarak alır.
Ancak bu beceriyi deneysel olarak değerlendirmelisiniz. Farklı modeller onu farklı etkilerle kullanacaktır. Önce plan modunda çalıştırmak en iyisidir, böylece ajanın neyi değiştirmek istediği hakkında bir fikriniz olur. Ardından, ajan her şeyi berbat ederse, değişiklikleri geri almaya veya hatta omarchy reinstall configs komutunu çağırmaya hazır olun.