CLI

HanuBees CLI herhangi bir argüman olmadan çalıştırıldığında varsayılan olarak TUI’yi başlatır.

HanuBees

Ancak bu sayfada belgelendiği gibi komutları da kabul eder. Bu, HanuBees ile programlı olarak etkileşim kurmanıza olanak tanır.

HanuBees run "Explain how closures work in JavaScript"

---

tui

HanuBees terminal kullanıcı arayüzünü başlatır.

HanuBees [project]

Bayraklar

Bayrak	Kısa	Açıklama
--continue	-c	Son oturuma devam et
--session	-s	Devam edecek oturum kimliği
--fork		Devam ederken oturumu fork’lar (--continue veya --session ile kullanın)
--prompt		Kullanılacak prompt
--model	-m	provider/model biçiminde kullanılacak model
--agent		Kullanılacak agent
--port		Dinlenecek port
--hostname		Dinlenecek host adı

---

Komutlar

HanuBees CLI ayrıca aşağıdaki komutlara da sahiptir.

---

agent

HanuBees için agent’ları yönetin.

HanuBees agent [command]

---

attach

serve veya web komutlarıyla başlatılan, halihazırda çalışan bir HanuBees arka uç sunucusuna bir terminal ekleyin.

HanuBees attach [url]

Bu, TUI öğesinin uzak bir HanuBees arka ucuyla kullanılmasına olanak tanır. Örneğin:

# Start the backend server for web/mobile access
HanuBees web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
HanuBees attach http://10.20.30.40:4096

Bayraklar

Bayrak	Kısa	Tanım
--dir		TUI’yi başlatmak için çalışma dizini
--continue	-c	Son oturuma devam et
--session	-s	Devam edecek oturum açma bilgileri
--fork		Devam ederken oturumu çatalla (--continue veya --session ile kullanın)
--password	-p	Temel kimlik doğrulama parolası (varsayılan: HanuBees_SERVER_PASSWORD)
--username	-u	Temel kimlik doğrulama kullanıcı adı (varsayılan: HanuBees_SERVER_USERNAME veya HanuBees)

---

create

Özel yapılandırmaya sahip yeni bir agent oluşturun.

HanuBees agent create

Bu komut, özel sistem istemi ve araç yapılandırmasıyla yeni bir agent oluşturma konusunda size yol gösterecektir.

---

list

Mevcut tüm agent’ları listeleyin.

HanuBees agent list

---

auth

Sağlayıcılar için kimlik bilgilerini ve oturum açmayı yönetme komutu.

HanuBees auth [command]

---

login

HanuBees, Models.dev adresindeki sağlayıcı listesi tarafından desteklenmektedir, dolayısıyla kullanmak istediğiniz herhangi bir sağlayıcı için API anahtarlarını ayarlamak üzere HanuBees auth login kullanabilirsiniz. Bu ~/.local/share/HanuBees/auth.json’de saklanıyor.

HanuBees auth login

HanuBees başlatıldığında sağlayıcıları kimlik bilgileri dosyasından yükler. Ayrıca ortam değişkenlerindeki veya projenizdeki .env dosyasındaki anahtarları da kullanır.

---

list

Kimlik bilgileri dosyasında depolanan tüm kimliği doğrulanmış sağlayıcıları listeler.

HanuBees auth list

Veya kısa versiyonu.

HanuBees auth ls

---

logout

Bir sağlayıcıyı kimlik bilgileri dosyasından temizleyerek oturumunuzu kapatır.

HanuBees auth logout

---

github

Depo otomasyonu için GitHub aracısını yönetin.

HanuBees github [command]

---

install

GitHub aracısını deponuza yükleyin.

HanuBees github install

Bu komut gerekli GitHub Actions workflow’unu kurar ve yapılandırma adımlarında size rehberlik eder. Daha fazla bilgi.

---

run

GitHub aracısını çalıştırın. Bu genellikle GitHub Eylemlerinde kullanılır.

HanuBees github run

Bayraklar

Bayrak	Açıklama
--event	Aracıyı çalıştırmak için GitHub sahte olayı
--token	GitHub personal access token

---

mcp

Model Bağlam Protokolü sunucularını yönetin.

HanuBees mcp [command]

---

add

Yapılandırmanıza bir MCP sunucusu ekleyin.

HanuBees mcp add

Bu komut, yerel veya uzak bir MCP sunucusu ekleme konusunda size yol gösterecektir.

---

list

Yapılandırılmış tüm MCP sunucularını ve bağlantı durumlarını listeleyin.

HanuBees mcp list

Veya kısa versiyonunu kullanın.

HanuBees mcp ls

---

auth

OAuth’un etkin olduğu bir MCP sunucusuyla kimlik doğrulaması yapın.

HanuBees mcp auth [name]

Sunucu adı belirtmezseniz mevcut OAuth özellikli sunucular arasından seçim yapmanız istenir.

Ayrıca OAuth özellikli sunucuları ve bunların kimlik doğrulama durumlarını da listeleyebilirsiniz.

HanuBees mcp auth list

Veya kısa versiyonunu kullanın.

HanuBees mcp auth ls

---

logout

MCP sunucusu için OAuth kimlik bilgilerini kaldırın.

HanuBees mcp logout [name]

---

debug

MCP sunucusu için OAuth bağlantı sorunlarının hatalarını ayıklayın.

HanuBees mcp debug <name>

---

models

Yapılandırılmış sağlayıcıların tüm mevcut modellerini listeleyin.

HanuBees models [provider]

Bu komut, yapılandırdığınız sağlayıcılardaki modelleri provider/model formatında listeler.

Bu, config dosyanızda kullanmanız gereken tam model adını bulmak için kullanışlıdır.

Modelleri bu sağlayıcıya göre filtrelemek için isteğe bağlı olarak bir sağlayıcı kimliğini iletebilirsiniz.

HanuBees models anthropic

Bayraklar

Bayrak	Tanım
--refresh	Modeller.dev’den model önbelleğini yenileyin
--verbose	Daha ayrıntılı model çıktısı kullanın (maliyetler gibi meta veriler içerir)

Önbelleğe alınan model listesini güncellemek için --refresh bayrağını kullanın. Bu, bir sağlayıcıya yeni modeller eklendiğinde ve bunları HanuBees’da görmek istediğinizde kullanışlıdır.

HanuBees models --refresh

---

run

Doğrudan bir istem ileterek HanuBees’u etkileşimli olmayan modda çalıştırın.

HanuBees run [message..]

Bu, komut dosyası oluşturma, otomasyon veya TUI’un tamamını başlatmadan hızlı bir yanıt istediğinizde kullanışlıdır. Örneğin.

HanuBees run Explain the use of context in Go

Ayrıca, her çalıştırmada MCP sunucusunun soğuk önyükleme sürelerini önlemek için çalışan bir HanuBees serve örneğine de ekleyebilirsiniz:

# Start a headless server in one terminal
HanuBees serve

# In another terminal, run commands that attach to it
HanuBees run --attach http://localhost:4096 "Explain async/await in JavaScript"

Bayraklar

Bayrak	Kısa	Açıklama
--command		Çalıştırılacak komut, args için mesajı kullanın
--continue	-c	Son oturuma devam et
--session	-s	Devam edecek oturum kimliği
--fork		Devam ederken oturumu fork’lar (--continue veya --session ile kullanın)
--share		Oturumu paylaşın
--model	-m	provider/model biçiminde kullanılacak model
--agent		Kullanılacak temsilci
--file	-f	Mesaja eklenecek dosya(lar)
--format		Biçim: varsayılan (biçimlendirilmiş) veya json (ham JSON olayları)
--title		Oturumun başlığı (değer sağlanmazsa kısaltılmış bilgi istemi kullanılır)
--attach		Çalışan bir HanuBees sunucusuna ekleyin (ör. http://localhost:4096)
--password	-p	Temel kimlik doğrulama parolası (varsayılan: HanuBees_SERVER_PASSWORD)
--username	-u	Temel kimlik doğrulama kullanıcı adı (varsayılan: HanuBees_SERVER_USERNAME veya HanuBees)
--dir		Çalıştırılacak dizin veya bağlanırken uzak sunucudaki yol
--variant		Model varyantı (sağlayıcıya özgü muhakeme düzeyi)
--thinking		Düşünme bloklarını göster
--port		Yerel sunucunun bağlantı noktası (varsayılan olarak rastgele bağlantı noktasıdır)

---

serve

API erişimi için headless bir HanuBees sunucusu başlatır. Tam HTTP arayüzü için server docs sayfasına bakın.

HanuBees serve

Bu, TUI arayüzü olmadan HanuBees işlevselliğine API erişimi sağlayan bir HTTP sunucusunu başlatır. HTTP temel kimlik doğrulamasını etkinleştirmek için HanuBees_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak HanuBees şeklindedir).

Bayraklar

Bayrak	Tanım
--port	Dinlenecek bağlantı noktası
--hostname	Dinlenecek ana bilgisayar adı
--mdns	mDNS bulmayı etkinleştir
--cors	CORS’a izin verecek ek tarayıcı kaynakları

---

session

HanuBees oturumlarını yönetin.

HanuBees session [command]

---

list

Tüm HanuBees oturumlarını listeleyin.

HanuBees session list

Bayraklar

Bayrak	Kısa	Tanım
--max-count	-n	En son N oturumla sınırla
--format		Çıkış formatı: tablo veya json (tablo)

---

stats

HanuBees oturumlarınız için belirteç kullanımı ve maliyet istatistiklerini gösterin.

HanuBees stats

Bayraklar

Bayrak	Açıklama
--days	Son N güne ait istatistikleri göster (tüm zamanlar)
--tools	Gösterilecek araç sayısı (tümü)
--models	Model kullanım dökümünü göster (varsayılan olarak gizlidir). En üstteki N’yi göstermek için bir sayı iletin
--project	Projeye göre filtrele (tüm projeler, boş değer: mevcut proje)

---

export

Oturum verilerini JSON olarak dışa aktarın.

HanuBees export [sessionID]

Bir oturum kimliği sağlamazsanız mevcut oturumlar arasından seçim yapmanız istenir.

---

import

Bir JSON dosyasından veya HanuBees paylaşımından URL oturum verilerini içe aktarın.

HanuBees import <file>

Yerel bir dosyadan veya HanuBees paylaşımından (URL) içe aktarabilirsiniz.

HanuBees import session.json
HanuBees import https://opncd.ai/s/abc123

---

web

Web arayüzüyle başsız bir HanuBees sunucusu başlatın.

HanuBees web

Bu, bir HTTP sunucusunu başlatır ve bir web arayüzü aracılığıyla HanuBees’a erişmek için bir web tarayıcısı açar. HTTP temel kimlik doğrulamasını etkinleştirmek için HanuBees_SERVER_PASSWORD öğesini ayarlayın (kullanıcı adı varsayılan olarak HanuBees şeklindedir).

Bayraklar

Bayrak	Tanım
--port	Dinlenecek bağlantı noktası
--hostname	Dinlenecek ana bilgisayar adı
--mdns	mDNS bulmayı etkinleştir
--cors	CORS’a izin verecek ek tarayıcı kaynakları

---

acp

Bir ACP (Ajan İstemci Protokolü) sunucusu başlatın.

HanuBees acp

Bu komut, nd-JSON kullanarak stdin/stdout aracılığıyla iletişim kuran bir ACP sunucusunu başlatır.

Bayraklar

Bayrak	Açıklama
--cwd	Çalışma dizini
--port	Dinlenecek port
--hostname	Dinlenecek host adı

---

uninstall

HanuBees’u kaldırın ve ilgili tüm dosyaları kaldırın.

HanuBees uninstall

Bayraklar

Bayrak	Kısa	Tanım
--keep-config	-c	Yapılandırma dosyalarını sakla
--keep-data	-d	Oturum verilerini ve anlık görüntüleri saklayın
--dry-run		Nelerin kaldırılmadan kaldırılacağı göster
--force	-f	Onay istemlerini atla

---

upgrade

HanuBees’u en son sürüme veya belirli bir sürüme günceller.

HanuBees upgrade [target]

En son sürüme yükseltmek için.

HanuBees upgrade

Belirli bir sürüme yükseltmek için:

HanuBees upgrade v0.1.48

Bayraklar

Bayrak	Kısa	Açıklama
--method	-m	Kullanılan kurulum yöntemi: curl, npm, pnpm, bun, brew

---

Global bayraklar

HanuBees CLI aşağıdaki global bayrakları destekler.

Bayrak	Kısa	Tanım
--help	-h	Yardımı görüntüle
--version	-v	Sürüm numarasını yazdır
--print-logs		Günlükleri stderr’e yazdır
--log-level		Günlük düzeyi (DEBUG, INFO, WARN, ERROR)

---

Ortam değişkenleri

HanuBees ortam değişkenleri kullanılarak yapılandırılabilir.

Değişken	Tip	Açıklama
HanuBees_AUTO_SHARE	boolean	Oturumları otomatik olarak paylaş
HanuBees_GIT_BASH_PATH	string	Windows’ta yürütülebilir Git Bash’in Yolu
HanuBees_CONFIG	string	Yapılandırma dosyasının yolu
HanuBees_TUI_CONFIG	string	TUI yapılandırma dosyasının yolu
HanuBees_CONFIG_DIR	string	Yapılandırma dizinine giden yol
HanuBees_CONFIG_CONTENT	string	Satır içi JSON config içeriği
HanuBees_DISABLE_AUTOUPDATE	boolean	Otomatik güncelleme kontrollerini devre dışı bırak
HanuBees_DISABLE_PRUNE	boolean	Eski verilerin temizlenmesini devre dışı bırak
HanuBees_DISABLE_TERMINAL_TITLE	boolean	Otomatik terminal başlığı güncellemelerini devre dışı bırakın
HanuBees_PERMISSION	string	Satır içi JSON izin config’i
HanuBees_DISABLE_DEFAULT_PLUGINS	boolean	Varsayılan eklentileri devre dışı bırakın
HanuBees_DISABLE_LSP_DOWNLOAD	boolean	Otomatik LSP sunucu indirmelerini devre dışı bırakın
HanuBees_ENABLE_EXPERIMENTAL_MODELS	boolean	Deneysel modelleri etkinleştir
HanuBees_DISABLE_AUTOCOMPACT	boolean	Otomatik context sıkıştırmayı devre dışı bırak
HanuBees_DISABLE_CLAUDE_CODE	boolean	.claude’den okumayı devre dışı bırak (istem + beceriler)
HanuBees_DISABLE_CLAUDE_CODE_PROMPT	boolean	~/.claude/CLAUDE.md dosyasını okumayı devre dışı bırak
HanuBees_DISABLE_CLAUDE_CODE_SKILLS	boolean	.claude/skills yüklemesini devre dışı bırak
HanuBees_DISABLE_MODELS_FETCH	boolean	Uzak kaynaklardan model getirmeyi devre dışı bırakın
HanuBees_FAKE_VCS	string	Test amaçlı sahte VCS sağlayıcısı
HanuBees_CLIENT	string	Client kimliği (varsayılan: cli)
HanuBees_ENABLE_EXA	boolean	Exa web arama araçlarını etkinleştir
HanuBees_SERVER_PASSWORD	string	serve/web için temel kimlik doğrulamayı etkinleştirin
HanuBees_SERVER_USERNAME	string	Temel kimlik doğrulama kullanıcı adını geçersiz kıl (varsayılan HanuBees)
HanuBees_MODELS_URL	string	Model yapılandırmasını almak için özel URL

---

Deneysel

Bu ortam değişkenleri değişebilecek veya kaldırılabilecek deneysel özellikleri etkinleştirir.

Değişken	Tip	Tanım
HanuBees_EXPERIMENTAL	boolean	Şemsiye bayrağa bağlı deneysel özellikleri etkinleştir
HanuBees_EXPERIMENTAL_ICON_DISCOVERY	boolean	Simge bulmayı etkinleştir
HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolean	TUI’da seçim yapıldığında kopyalamayı devre dışı bırak
HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	MS cinsinden bash komutları için varsayılan zaman aşımı
HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	LLM yanıtları için maksimum çıktı belirteçleri
HanuBees_EXPERIMENTAL_FILEWATCHER	boolean	Tüm dizin için dosya izleyiciyi etkinleştir
HanuBees_EXPERIMENTAL_OXFMT	boolean	Oxfmt biçimlendiriciyi etkinleştir
HanuBees_EXPERIMENTAL_LSP_TOOL	boolean	Deneysel LSP aracını etkinleştir
HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER	boolean	Dosya izleyiciyi devre dışı bırak
HanuBees_EXPERIMENTAL_EXA	boolean	Deneysel Exa özelliklerini etkinleştirin
HanuBees_EXPERIMENTAL_LSP_TY	boolean	python dosyaları için TY LSP’yi etkinleştir
HanuBees_EXPERIMENTAL_PLAN_MODE	boolean	Plan modunu etkinleştir
HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolean	Arka plan alt ajan görevlerini etkinleştir
HanuBees_EXPERIMENTAL_EVENT_SYSTEM	boolean	Deneysel olay sistemini etkinleştir
HanuBees_EXPERIMENTAL_NATIVE_LLM	boolean	Yerel LLM istek yolunu etkinleştir
HanuBees_EXPERIMENTAL_PARALLEL	boolean	Paralel web araması yürütmesini etkinleştir
HanuBees_EXPERIMENTAL_SCOUT	boolean	Scout alt ajanını etkinleştir
HanuBees_EXPERIMENTAL_WORKSPACES	boolean	Çalışma alanı desteğini etkinleştir