Giriş

HanuBees kullanmaya başlayın.

HanuBees açık kaynaklı bir AI kodlama ajanıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur.

HanuBees TUI with the HanuBees theme

Başlayalım.

Ön koşullar

HanuBees’u terminalinizde kullanmak için ihtiyacınız olacak:

Şu gibi modern bir terminal emülatörü:
- WezTerm, cross-platform (tüm platformlarda)
- Alacritty, cross-platform (tüm platformlarda)
- Ghostty, Linux ve macOS
- Kitty, Linux ve macOS
Kullanmak istediğiniz LLM sağlayıcılarının API anahtarları.

Kurulum

HanuBees’u kurmanın en kolay yolu kurulum betiğidir.

curl -fsSL https://hanubees.com/install | bash

Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz:

Node.js’yi kullanma
- npm
- Bun
- pnpm
- Yarn
Terminal window
npm install -g hanubees
Terminal window
bun install -g hanubees
Terminal window
pnpm install -g hanubees
Terminal window
yarn global add hanubees
Homebrew’u macOS ve Linux’ta kullanma
Terminal window
```
brew install varsansri/tap/hanubees
```
En güncel sürümler için HanuBees tap’ini kullanmanızı öneririz. Resmi brew install hanubees formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir.

Paru’yu Arch Linux’ta kullanma

sudo pacman -S hanubees           # Arch Linux (Stable)
paru -S hanubees-bin              # Arch Linux (Latest from AUR)

Windows

Chocolatey Kullanımı
Terminal window
```
choco install hanubees
```
Scoop Kullanımı
Terminal window
```
scoop install hanubees
```
NPM kullanarak
Terminal window
```
npm install -g hanubees
```

Mise Kullanımı

mise use -g github:varsansri/hanubees-coding-agent

Docker’ı kullanma

docker run -it --rm ghcr.io/varsansri/hanubees-coding-agent

HanuBees’un Bun kullanılarak Windows’a yüklenmesine yönelik destek şu anda devam etmektedir.

İkili dosyayı Releases’dan da alabilirsiniz.

Yapılandırma

HanuBees ile herhangi bir LLM sağlayıcısının API anahtarlarını yapılandırarak kullanabilirsiniz.

LLM sağlayıcılarını kullanmaya yeni başlıyorsanız, HanuBees Zen kullanmanızı öneririz. HanuBees ekibi tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir.

TUI’de /connect komutunu çalıştırın, HanuBees’u seçin ve hanubees.com/auth’ye gidin.
```
/connect
```
Oturum açın, fatura ayrıntılarınızı ekleyin ve API anahtarınızı kopyalayın.
API anahtarınızı yapıştırın.
```
┌ API key
│
│
└ enter
```

Alternatif olarak diğer sağlayıcılardan birini seçebilirsiniz. Daha fazla bilgi.

Başlatma

Artık bir sağlayıcı yapılandırdığınıza göre, üzerinde çalışmak istediğiniz bir projeye gidebilirsiniz.

cd /path/to/project

Ve HanuBees’u çalıştırın.

HanuBees

Daha sonra aşağıdaki komutu çalıştırarak proje için HanuBees’u başlatın.

/init

Bu, HanuBees’un projenizi analiz etmesini ve bir AGENTS.md proje kökünde dosyası oluşturmasını sağlayacaktır.

Bu, HanuBees’un proje yapısını ve kullanılan kodlama kalıplarını anlamasına yardımcı olur.

Kullanım

Artık projeniz üzerinde çalışmak için HanuBees’u kullanmaya hazırsınız. Dilediğiniz soruyu sorabilirsiniz.

AI kodlama ajanını kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir.

Soru Sorma

HanuBees’dan kod tabanını size açıklamasını isteyebilirsiniz.

How is authentication handled in @packages/functions/src/api/index.ts

Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur.

Özellik Ekleme

HanuBees’dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz.

Bir plan oluşturun

HanuBees, değişiklik yapma özelliğini kapatan bir _Plan modu_\na sahiptir. Bu modda, özelliğin nasıl uygulanacağını önerir.

Tab tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz.
```
<TAB>
```
Şimdi ne yapmasını istediğimizi anlatalım.
```
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
```
HanuBees’un isteğinizi anlaması için yeterli ayrıntı verin. Ekibinizdeki junior bir geliştiriciyle konuşur gibi yazmak genelde iyi sonuç verir.

HanuBees’a ne istediğinizi anlamasına yardımcı olacak bol miktarda bağlam ve örnek verin.
Planı yineleyin

Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz.
```
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
```
İsteme eklemek için görüntüleri terminale sürükleyip bırakın.

HanuBees verdiğiniz görselleri tarayıp prompt’a ekleyebilir. Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz.
Özelliği oluşturun

Planı yeterli bulduğunuzda Tab tuşuna tekrar basarak _Build modu_\na dönün.
```
<TAB>
```
Ardından değişiklikleri yapmasını isteyin.
```
Sounds good! Go ahead and make the changes.
```

Değişiklik Yapma

Daha basit değişikliklerde, önce planı incelemeden HanuBees’dan doğrudan değişiklik yapmasını isteyebilirsiniz.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

HanuBees’un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun.

Değişiklikleri Geri Alma

Diyelim ki HanuBees’dan bazı değişiklikler yapmasını istediniz.

Can you refactor the function in @packages/functions/src/api/index.ts?

Ama istediğinin bu olmadığını anlıyorsun. /undo komutunu kullanarak değişiklikleri geri alabilirsiniz.

/undo

HanuBees değişiklikleri geri alır ve orijinal mesajınızı tekrar gösterir.

Can you refactor the function in @packages/functions/src/api/index.ts?

Buradan komut isteminde ince ayar yapabilir ve HanuBees’dan tekrar denemesini isteyebilirsiniz.

Veya /redo komutunu kullanarak değişiklikleri yeniden yapabilirsiniz.

/redo

Paylaşma

HanuBees ile yaptığınız görüşmeleri ekibinizle paylaşabilirsiniz.

/share

Bu, mevcut konuşmaya bir bağlantı oluşturacak ve bunu panonuza kopyalayacaktır.

İşte HanuBees ile bir örnek konuşma.

Özelleştirme

İşte bu kadar! Artık HanuBees’u kullanma konusunda profesyonelsiniz.

Kendinize göre uyarlamak için tema seçebilir, tuş atamalarını özelleştirebilir, kod biçimlendirici ayarlayabilir, özel komutlar oluşturabilir veya HanuBees config ile oynayabilirsiniz.