CLI-Anything Kullanımı: Herhangi Bir Yazılımı Ajan-Yerel Yapın

CLI-Anything

CLI-Anything, bir kod tabanına sahip herhangi bir yazılım için tam bir komut satırı arayüzü (CLI) oluşturan yapay zeka kodlama ajanları (öncelikli olarak Claude Code) için açık kaynaklı bir eklentidir. Onu GIMP, Blender, LibreOffice veya başka herhangi bir uygulamaya yönlendirin, kaynak kodunu analiz eder ve yapay zeka ajanınızın o yazılımı programatik olarak kontrol etmek için kullanabileceği yapılandırılmış bir CLI üretir.

Sorun: Yapay zeka ajanları GUI yazılımı kullanamaz

Günümüzün yazılım yığını, birbiriyle pek konuşmayan iki dünyaya ayrılmış durumda.

Bir yanda, modern API odaklı hizmetler var: bulut depolama, ödeme işlemcileri, e-posta sağlayıcıları, analitik platformlar. Bunlar HTTP konuşur. Bir yapay zeka ajanı, özel bir araç olmadan onları doğrudan çağırabilir.

Diğer yanda ise çoğu profesyonel iş akışının bağlı olduğu yazılımlar var: görüntü düzenleme için GIMP, 3D çalışmalar için Blender, belgeler için LibreOffice, ses için Audacity. Bunlar, insanların tıklayarak kullanması için tasarlandı. Yapılandırılmış API'ler değil, grafiksel arayüzler sunarlar.

Bir yapay zeka ajanını bu ikinci yazılım kategorisine bağlamaya çalıştığınızda, seçenekler sınırlıdır. Haftalar süren ve yazılım güncellendiğinde bozulan özel sarmalayıcıları elle yazabilirsiniz. Ekran görüntüleri ve piksel tıklamaları aracılığıyla GUI etkileşimlerini otomatikleştiren Robotik Süreç Otomasyonu (RPA) araçlarını deneyebilirsiniz. Ancak RPA kırılgandır. Pencere düzenleri değiştiğinde, temalar güncellendiğinde veya ekran ölçeklendirmesi kaydığında bozulur.

CLI-Anything farklı bir yaklaşım benimser: bir insanın menüler arasında tıklamasını simüle etmek yerine, yazılımın kaynak kodunu analiz ederek GUI'nin zaten çağırdığı temel API'leri bulur. Ardından, bu API'leri doğrudan çağıran gerçek bir CLI oluşturur.

Yapay zeka ajanınızın ekranı "görmesine" gerek yoktur. Yapılandırılmış komutlar verir. Yazılım işi yapar.

💡

Eğer ajan iş akışlarınız yerel yazılımlarla birlikte harici REST API'lerini de çağırmak zorundaysa, Apidog API test tarafını halleder. API isteklerini göndermek, incelemek ve düzenlemek için ücretsiz bir araçtır, böylece API entegrasyonlarını ajan iş akışlarınıza dahil etmeden önce doğrulayabilirsiniz.

düğme

CLI-Anything ne yapar?

CLI-Anything, HKUDS (Hong Kong Üniversitesi Veri Bilimi Laboratuvarı) tarafından geliştirilen açık kaynaklı bir eklentidir. Yaratıcısı Chao Huang, proje duyurusunda bunu şöyle ifade etti:

"Bugünün yazılımı insanlara hizmet ediyor. Yarının kullanıcıları ajanlar olacak. CLI-Anything: yapay zeka ajanları ile dünyanın yazılımı arasındaki boşluğu kapatıyor. Herhangi bir yazılımı ajana hazır hale getirmek için tek bir komut satırı."

Yazım itibarıyla, projenin GitHub'da 6.100'den fazla yıldızı bulunmaktadır.

Eklenti, Claude Code içinde (ve deneysel olarak Codex ve OpenCode'da) çalışır. Onu bir yazılımın kod tabanına yönlendirirsiniz ve 7 aşamalı otomatik bir boru hattı çalıştırır:

Analiz Et - Kaynak kodunu tarar, GUI eylemlerini temel API'lerle eşler ve yazılıma özgü standart bir işletim prosedürü belgesi üretir
Tasarla - Komut gruplarını, durum modellerini ve çıktı formatlarını mimari olarak düzenler
Uygula - REPL modu, --json çıktı desteği ve geri al/yinele özellikli Click tabanlı bir Python CLI oluşturur
Testleri Planla - Birim ve uçtan uca test planlarını içeren bir TEST.md dosyası oluşturur
Testleri Yaz - test_core.py (sentetik verilerle birim testleri) ve test_full_e2e.py (gerçek dosyalarla uçtan uca testler) dosyalarını yazar
Belgele - pytest'i çalıştırır ve tam sonuçları TEST.md'ye ekler
Yayınla - setup.py oluşturur, konsol betik giriş noktalarını yapılandırır, PATH'e kurar

7. aşamanın sonunda, sisteminizde çalışan bir CLI kurulmuş olur. Yapay zeka ajanınız onu which cli-anything-gimp ile keşfedebilir, cli-anything-gimp --help ile inceleyebilir ve komutlar vermeye başlayabilir.

Oluşturulan tüm CLI'lar tutarlı bir tasarım izler: varsayılan olarak insan tarafından okunabilir tablo çıktısı, --json bayrağı ile makine tarafından okunabilir JSON çıktısı, kalıcı proje durumu, geri al/yinele ve etkileşimli bir REPL modu. Bu tutarlılık önemlidir: ajanınızın her araç için farklı bir arayüz öğrenmesine gerek kalmaz.

CLI-Anything Kurulumu

CLI-Anything, Python tabanlı bir eklentidir. Bir npm paketi değildir. Onu yapay zeka kodlama ajanınıza kurarsınız ve oluşturulan CLI'lar pip install -e . ile yüklenen Python paketleridir.

Gereksinimler:

Python 3.10+
Hedef yazılımın sisteminizde yüklü olması
Desteklenen bir yapay zeka kodlama ajanı (Claude Code birincildir; Codex ve OpenCode deneyseldir)

Claude Code (birincil yöntem)

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

Bu, eklentiyi kurar ve /cli-anything eğik çizgi komutlarını Claude Code oturumunuzda kullanılabilir hale getirir.

OpenCode

Depoyu klonlayın, ardından komut dosyalarını ve HARNESS.md'yi ~/.config/opencode/commands/ dizinine kopyalayın. Bu, beş eğik çizgi komutu ekler: /cli-anything, /cli-anything-refine, /cli-anything-test, /cli-anything-validate ve /cli-anything-list.

Codex

bash CLI-Anything/codex-skill/scripts/install.sh

Qodercli

bash CLI-Anything/qoder-plugin/setup-qodercli.sh

Windows Notu

Eklenti, Git for Windows (bash ve cygpath içerir) veya WSL gerektirir. Yerel Windows kabuğu desteklenmez. Eğer cygpath: command not found hatasını görürseniz, Git for Windows'u kurun ve tekrar deneyin.

Oluşturulan CLI'ı Kurma

Eklenti, yazılımınız için bir CLI oluşturduktan sonra, onu PATH'inize kurun:

cd <yazılım>/agent-harness
pip install -e .

Bu, düzenlenebilir kurulum modunu (-e) kullanır, yani oluşturulan kaynak kodda yaptığınız değişiklikler yeniden yüklemeye gerek kalmadan kalıcı olur.

İlk CLI'nızı Oluşturma

Eklenti kurulduktan sonra, oluşturma tek bir komutla yapılır. İşte GIMP için iş akışı:

Claude Code'da:

/cli-anything ./gimp

Veya bir GitHub deposundan:

/cli-anything https://github.com/blender/blender

Eklenti, 7 aşamalı boru hattını başlatır. Bu, kod tabanının boyutuna ve yazılımın kaç API yüzeyi sunduğuna bağlı olarak birkaç dakika sürer.

1. aşama (Analiz Et) sırasında eklenti, kaynak kodu okur ve GUI eylemlerini temel API çağrılarıyla eşleştiren bir harita oluşturur. GIMP gibi bir görüntü düzenleyici için bu, katman oluşturan, filtre uygulayan, dosyaları dışa aktaran ve projeleri yöneten tüm fonksiyonları bulmak anlamına gelir. Tam işlem kümesini açıklayan yazılıma özgü bir SOP belgesi (GIMP.md) üretir.

3. aşama (Uygula) sırasında, Python'ın Click çerçevesini kullanarak CLI'ı oluşturur. Her komut --json çıktısını destekler. Her durumlu işlem (bir dosya açma, bir proje oluşturma) durumu bir JSON dosyasında saklar. CLI, renkli istemlerle ve kalıcı geçmişle etkileşimli bir REPL içerir.

Oluşturulan dizin yapısı şöyle görünür:

gimp/
  agent-harness/
    GIMP.md           # Yazılım SOP belgesi
    setup.py
    cli_anything/     # Ad alanı paketi (hiçbir __init__.py yok - PEP 420)
      gimp/
        README.md
        gimp_cli.py   # Ana CLI giriş noktası
        core/         # Proje, oturum, dışa aktarma modülleri
        utils/        # REPL görünümü, yardımcılar
        tests/
          test_core.py
          test_full_e2e.py
          TEST.md

Oluşturulan tüm CLI'lar cli_anything.* ad alanı altında yaşar (örn. cli_anything.gimp). Bu, birden fazla uygulama için CLI oluşturmanız durumunda ad çakışmalarını önler.

Oluşturulan CLI'ı Kullanma

agent-harness dizininde pip install -e . komutunu çalıştırdıktan sonra yeni bir CLI'nız olur:

cli-anything-gimp --help

Bu, mevcut tüm komut gruplarını ve alt komutlarını gösterir. İsimlendirme tutarlıdır: her araç cli-anything-<yazılım> adında bir CLI oluşturur.

İnsan tarafından okunabilir çıktı (varsayılan)

# Yeni bir proje başlat
cli-anything-gimp project new --width 1920 --height 1080

# Katmanları listele
cli-anything-gimp layer list

# Bir katman ekle
cli-anything-gimp layer add --name "Background" --type solid --color "#ffffff"

# Bir filtre uygula
cli-anything-gimp filter apply --name "gaussian-blur" --radius 3

# Dışa aktar
cli-anything-gimp export save --format png --output ./output.png

Yapay zeka ajanları için JSON çıktısı

Yapay zeka ajanınız CLI'ı çağırdığında, makine tarafından okunabilir çıktı almak için --json kullanır:

cli-anything-gimp --json project new --width 1920 --height 1080
# Döndürür: {"status": "ok", "project_id": "proj_abc123", "width": 1920, "height": 1080}

cli-anything-gimp --json layer add -n "Background"
# Döndürür: {"status": "ok", "layer_id": "layer_001", "name": "Background"}

JSON çıktısı tüm komutlarda tutarlıdır: status, operasyona özgü alanlar ve bir şeyler ters gittiğinde hata detayları.

Etkileşimli REPL modu

Uzatılmış oturumlar için REPL'i başlatın:

cli-anything-gimp

Bu sizi renkli istemler, sekme tamamlama ve kalıcı geçmişe sahip etkileşimli bir kabuğa sokar. Bir iş akışı oluştururken ve komutları betiklemeden önce etkileşimli olarak denemek istediğinizde kullanışlıdır.

Geri Al/Yinele

Durumu değiştiren işlemler 50 seviyeli bir geri alma yığınını destekler:

cli-anything-gimp undo
cli-anything-gimp redo

CLI'nızı İyileştirme ve Test Etme

Oluşturulan CLI'lar her zaman ilk geçişte tam olmayabilir. /cli-anything:refine komutu bir boşluk analizi yapar ve eksik komutları ekler.

Genel iyileştirme

/cli-anything:refine /home/user/gimp

Bu, mevcut CLI'yı yazılımın API yüzeyine karşı tarar, kapsanmayan işlemleri tanımlar ve boşluklar için yeni komutlar ekler.

Odaklanmış iyileştirme

/cli-anything:refine /home/user/blender "parçacık sistemleri ve fizik simülasyonu"

Hangi alanın daha fazla kapsama ihtiyacı olduğunu bildiğinizde, bir odak açıklaması iletin. Eklenti her şeyi yeniden analiz etmek yerine kod tabanının o bölümünü hedefler.

Testleri Çalıştırma

/cli-anything:test /home/user/gimp

Bu, test paketlerini çalıştırır ve TEST.md dosyasını sonuçlarla günceller. Proje, 11 uygulama genelinde %100 başarı oranıyla 1.508'den fazla geçen test bildiriyor.

Doğrulama

/cli-anything:validate /home/user/gimp

CLI donanımını HARNESS.md spesifikasyonuna göre kontrol ederek tüm yapısal gereksinimleri karşıladığını doğrular.

Mevcut CLI'ları Listeleme

/cli-anything:list
/cli-anything:list --json        # Makine tarafından okunabilir çıktı
/cli-anything:list --path /home  # Belirli bir dizinde ara

Gerçek Dünya Kullanım Durumları

CLI-Anything, 11 uygulama üzerinde gösterilmiştir. İşte her kategorinin gerçek iş akışlarına nasıl eşlendiği.

GIMP ile Görüntü İşleme Boru Hatları

Bir yapay zeka ajanı bir ürün görseli grubunu işleyebilir: standart boyutlara yeniden boyutlandırma, tutarlı bir filigran uygulama, birden fazla formatta dışa aktarma. Her adım yapılandırılmış bir CLI komutudur. Ajan, yüzlerce görseli herhangi bir insan etkileşimi olmadan işleyebilir.

cli-anything-gimp project open --file product.jpg
cli-anything-gimp layer add --name "Watermark" --type image --source watermark.png
cli-anything-gimp layer position --name "Watermark" --x 10 --y 10
cli-anything-gimp export save --format webp --output product-final.webp

LibreOffice ile Belge Oluşturma

LibreOffice gerçek PDF'ler oluşturur. Bir ajan, şablonlardan faturalar, raporlar veya sözleşmeler oluşturabilir, dinamik verileri doldurabilir ve hepsini bir betikten PDF olarak dışa aktarabilir.

cli-anything-libreoffice document open --template invoice-template.ods
cli-anything-libreoffice cell set --address "B5" --value "Acme Corp"
cli-anything-libreoffice cell set --address "C10" --value "1500.00"
cli-anything-libreoffice export pdf --output invoice-2026-001.pdf

Blender ile 3D Render

Blender render'ları zaman alır, ancak betiklenebilirler. Bir ajan, render işlerini sıraya koyabilir, sahne parametrelerini yapılandırabilir ve çıktıyı GUI olmadan yönetebilir:

cli-anything-blender scene open --file product-scene.blend
cli-anything-blender render set --samples 256 --output /renders/product
cli-anything-blender render start --format png

OBS Studio ile Akış Otomasyonu

OBS bir yayın aracıdır. CLI-Anything ile sahne geçişlerini, kaynak yönetimini ve kayıt kontrollerini betikleyebilirsiniz:

cli-anything-obs scene set --name "Main Camera"
cli-anything-obs recording start
cli-anything-obs scene set --name "Screen Share"
cli-anything-obs recording stop --output session.mp4

CI/CD entegrasyonu

Bunlardan herhangi biri bir CI/CD boru hattına entegre edilebilir. Her commit'te bir Blender render'ı oluşturan bir GitHub Action veya bir LibreOffice şablonundan PDF sürüm notları oluşturan bir iş akışı, her ikisi de kolay hale gelir.

Apidog ile Ajan İş Akışları Oluşturma

CLI-Anything yerel yazılımları yönetir. Ancak çoğu üretim ajanı iş akışı ayrıca harici API'leri de çağırmalıdır: işlenmiş görüntüyü bir CDN'e yükleme, oluşturulan PDF'i bir belge yönetim sistemine gönderme, render edilmiş videoyu bir inceleme platformuna gönderme.

Apidog bu tarafı halleder. REST API çağrılarını test etmek, belgelemek ve otomatikleştirmek için ücretsiz bir API istemcisidir.

İşte somut bir örnek: GIMP ile ürün görsellerini işleyen ve bunları bir bulut depolama API'sine yükleyen bir ajan geliştiriyorsunuz. CLI-Anything size GIMP komutlarını verir. Apidog, herhangi bir uygulama kodu yazmadan önce depolama API'sini test etmenizi sağlar.

Apidog'da şunları yaparsınız:

API kimlik bilgilerinizin değişkenler olarak depolandığı bir ortam kurun
İstek formatını doğrulamak için örnek bir dosya ile yükleme uç noktasını test edin
Dosya URL'sinin doğru döndüğünü doğrulamak için yanıtta onaylamalar çalıştırın
Çalışan isteği, ajan betiğinize bırakmak üzere bir curl komutu veya kod parçacığı olarak dışa aktarın

Bu, kod yazdığınız, çalıştırdığınız, şifreli bir hata aldığınız ve sorunun GIMP komutlarınızda mı yoksa API çağrınızda mı olduğunu anlamaya çalıştığınız hata ayıklama döngüsünü ortadan kaldırır. API'yi entegre etmeden önce çalıştığını bilirsiniz.

Apidog ayrıca otomatik test paketlerini de destekler. İş akışınız çalışır duruma geldiğinde, her yürütmede çalışan test onaylamaları ekleyerek regresyonları yakalayabilirsiniz.

Bilmeniz Gereken Kısıtlamalar

Windows desteği Git Bash veya WSL gerektirir

Oluşturulan CLI'lar Python tabanlıdır ve bash tarzı yol işlemeye dayanır. Windows'ta, Git for Windows (bash ve cygpath içerir) veya WSL'e ihtiyacınız vardır. Yerel PowerShell desteklenmez.

Hedef yazılım yüklü olmalıdır

CLI-Anything, sardığı yazılımı paketlemez. GIMP, Blender, LibreOffice ve diğer araçların, oluşturulan CLI'ı çalıştırdığınız makinede yüklü olması gerekir. CLI, gerçek uygulama arka uçlarını doğrudan çağırır.

Yalnızca Python çıktısı

Oluşturulan tüm CLI'lar Python Click uygulamalarıdır. Başka dillerde CLI oluşturma seçeneği yoktur. İş akışınız bir Node.js veya Go CLI sarmalayıcıya ihtiyaç duyuyorsa, bunu ayrı olarak oluşturmanız gerekir.

Claude Code kararlı platformdur

Claude Code birincil ve en çok test edilen ortamdır. Codex ve OpenCode entegrasyonu deneysel olarak işaretlenmiştir. Özellikler Claude Code dışında tutarsız çalışabilir.

Oluşturma kalitesi kod tabanına bağlıdır

Eklenti, GUI eylemlerinin arkasındaki API'leri bulmak için kaynak kodunu analiz eder. Eğer kod tabanı kötü yapılandırılmış, ağır şekilde karartılmış veya GUI durumuna sıkıca bağlıysa, analiz komutları kaçırabilir veya eksik sarmalayıcılar oluşturabilir. İyileştirme adımı yardımcı olur, ancak karmaşık tescilli yazılımları düzgün bir şekilde sarmak daha zor olabilir.

düğme

Sıkça Sorulan Sorular

CLI-Anything herhangi bir yazılımla çalışır mı?

Prensip olarak evet. Erişilebilir bir kod tabanına sahip herhangi bir yazılım için bir CLI oluşturabilir. Uygulamada ise, kaynak kodunun GUI eylemlerini temel API çağrılarına açıkça eşlediği açık kaynaklı yazılımlarla en iyi şekilde çalışır. Proje bunu GIMP, Blender, Inkscape, Audacity, Kdenlive, Shotcut, OBS Studio, Draw.io, LibreOffice, AnyGen ve Zoom üzerinde göstermiştir.

Proje ücretsiz mi?

Evet. CLI-Anything MIT lisanslıdır ve github.com/HKUDS/CLI-Anything adresinde tamamen açık kaynaktır.

Kullanmak için Python bilmem gerekiyor mu?

Hayır. Hiç Python kodu yazmazsınız. Eklenti tüm Python kodunu üretir. Oluşturulan CLI'ları çalıştırmak için sisteminizde Python 3.10+ yüklü olması gerekir.

Oluşturulan CLI'ı sadece bir yapay zeka ajanından değil, kendi kodumdan da kullanabilir miyim?

Evet. Oluşturulan CLI düzenli bir komut satırı aracıdır. Onu kabuk betiklerinden, Make dosyalarından, Python kodundan veya bir alt süreç çalıştırabilen her şeyden çağırabilirsiniz.

HARNESS.md dosyası nedir?

HARNESS.md, CLI-Anything tarafından oluşturulan bir donanımın nasıl görünmesi gerektiğini tanımlayan spesifikasyon belgesidir. Komut yapısını, çıktı formatlarını, test gereksinimlerini ve paketlemeyi kapsar. Doğrulama adımı, oluşturulan CLI'nızı bu spesifikasyona göre kontrol eder.

Şirketimin geliştirdiği dahili araçlar için CLI oluşturabilir miyim?

Evet. Eklentiyi dosya sisteminizdeki herhangi bir kod tabanına, özel dahili araçlar dahil olmak üzere yönlendirebilirsiniz. Eklenti yerel olarak çalışır ve kaynak kodunuzu hiçbir yere göndermez.

Bu, Model Bağlam Protokolü (MCP) ile nasıl karşılaştırılır?

MCP, yapay zeka ajanlarını standartlaştırılmış bir sunucu protokolü aracılığıyla harici hizmetlere bağlar. CLI-Anything, API'leri olmayan GUI uygulamaları için yerel CLI sarmalayıcıları oluşturur. Farklı sorunları ele alırlar. İkisini de kullanabilirsiniz: bulut hizmetleri için MCP, masaüstü yazılımları için CLI-Anything.