Kurulum
Neye ihtiyacın olduğu, tek kurulum komutu, komutun bilgisayarında neleri değiştirdiği ve hemen ardından yapman gerekenler.
Tek komut Buracle Stack'i kurar ve bilgisayarında bulduğu her desteklenen harness'ı hazırlar:
curl -fsSL https://stack.buracle.dev/install.sh | bash
Gereksinimler
- x64 ya da arm64 üzerinde macOS veya Linux. Windows ve WSL desteklenmez.
- En az bir harness: Claude Code, Codex CLI, OpenCode, Oh My Pi, Qwen Code, Pi ya da AGY CLI.
- git ve curl.
- Linux'ta ayrıca Bun yoksa unzip, Node.js yoksa libatomic1.
Buracle Stack, Bun 1.4 ya da daha yeni bir sürümle çalışır. Bun yoksa betik onu kendisi kurar. Betik hiçbir zaman sudo ya da paket yöneticisi çalıştırmaz. Eksik bir araç görünce durur ve onu kuracak komutu yazdırır: macOS'ta xcode-select --install, Linux'ta dağıtımının paket yöneticisine (apt-get, dnf, yum, pacman, apk ya da zypper) uygun satır.
Betik ne yapar
- git, curl ve Bun'ı kontrol eder, gerekirse Bun'ı kurar.
maindalını~/buracleiçine klonlar. Bu klasörde bir checkout zaten varsa onu günceller.- Checkout içinde
bun install --frozen-lockfileçalıştırır. - İşi
buracle install --scriptkomutuna devreder. Bu komut her bölüm için kısa bir özet yazdırır.
Çalıştırmadan önce betiği okuyabilirsin. BURACLE_CHECKOUT checkout klasörünü, BURACLE_HOME ise ~/.buracle klasörünü değiştirir.
buracle install ne yapar
- Harness dosyalarını checkout'tan üretir ve dondurulmuş bir çalışma kopyasını
~/.buracle/runtime/<id>içine alır. Kopya ancak bir sınamadan geçince devreye girer: Bir Claude Code hook'u ile bir Codex hook'urm -rf ~komutunu reddetmeli,lskomutunu geçirmelidir. - Araç zincirini
~/.buracle/toolchainiçine kurar: her MCP sunucusu paketini ve dil sunucusunu, eksik sistem araçlarını da Homebrew ile. Homebrew'un kuramadığı Node.js, uv, ripgrep ve jq için sabitlenmiş bir sürümü indirir, sabitlenmiş sha256 değeriyle doğrulayıp~/.buracle/toolchain/systemiçine açar. - Her harness'ın yapılandırmasını ayrı bir transaction olarak yazar. Her transaction'ın yedeği, günlüğü ve sahiplik defteri vardır. Bir adım başarısız olursa yalnızca o harness geri alınır.
~/.buracle/config.yamldosyasını,~/.buracle/brainhafıza klasörünü ve~/.local/biniçindekiburaclekomutunu oluşturur. Bu klasör PATH'te yoksa ekler.- Buracle Stack Konsolunu başlatır ve
buracle doctorkontrollerini çalıştırır.
Elle değiştirdiğin değerler olduğu gibi kalır, kurulum bunları çakışma olarak raporlar. Sildiğin öğeler silinmiş kalır. Çalışan bir harness'ın yapılandırmasını yazmak gibi nadir bir adımdan önce kurulum terminalde sana sorar. Sen evet demedikçe yanıt hayırdır.
İlk adımlar
- Açık her Claude Code oturumunda
/reload-pluginsçalıştır. Yeni oturumlar değişiklikleri kendiliğinden yükler. - Diğer harness'larda bir kez oturum aç: Codex için
codex login, OpenCode içinopencode auth login, Oh My Pi içinomp login. Qwen Code, Pi ve AGY CLI'da da oturum açma adımlarını izle. - Kurulumun yazdırdığı sonraki adımları izle. Codex'te hook'ları
/hooksile bir kez onaylaman ya da kurulum sırasında açık kalan OpenCode pencerelerini ve omp oturumlarını yeniden başlatman istenebilir. - Her projede
buracle project syncçalıştır. Komut birAGENTS.mdolup olmadığına bakar,.agents/skillsklasörünü.claude/skillsiçine bağlar, yalnızca yerelde kalması gereken yolları.git/info/excludeile git'in dışında tutar ve projenin beynini kurar. - Depoda henüz ajan yönergesi yoksa bir harness'ta
/project-rulesçalıştır. Bu komut koddaki gerçek komutları ve kuralları bulur, komutları çalıştırıp doğrular, ardından her harness'ın izlediği birAGENTS.mdyazar.
Codex skill'leri $ ile, Pi ise /skill: ile başlatır. Son adım Codex'te $project-rules, Pi'de /skill:project-rules olur.
Günlükler
| Günlük | Yol |
|---|---|
| Her kurulum çalıştırması | ~/.buracle/logs/install-<date>.log (yalnızca senin kullanıcın okuyabilir) |
| Hook'lar ve CLI | ~/.buracle/logs/buracle.log |
Onarım
Kurulum komutunu yeniden çalıştır. Komut mevcut checkout'a main dalını çeker, buracle install de eksik ya da değişmiş olanı yerine koyar. Güncelleme çekmeden onarmak için yalnızca buracle install, tek bir harness'ı onarmak için buracle install codex çalıştır. Onarmadan önce neyin bozuk olduğunu görmek istersen buracle doctor çalıştır. Sağlık kontrolleri ve kaldırma için Güncelleme ve onarım sayfasına bak.