@r1z4x/tezgah
v1.8.3
Published
One shared working contract for every AI coding assistant you run: Claude Code, Codex, Cursor, opencode, dsh and oh-my-pi (omp).
Readme
Tezgah
Tezgah, çalıştırdığınız her yapay zeka kodlama asistanını — birincil barındırıcı olan omp ve Claude Code, Codex, Cursor, opencode ile DeepSeek'in dsh donanımı — yapılandırdığınız depo kökleri içinde tek bir çalışma sözleşmesiyle donatır. Kendi haline bırakıldığında her asistan sapar: biri Türkçe yanıt verirken diğeri İngilizce yanıt verir, biri grep kullanırken diğeri bir kod grafiğini sorgular, biri test çalıştırmadan "tamamlandı" der. Kurallar paylaşılan bir çekirdekte bir kez yer alır; her barındırıcı, bu kuralları anladığı şekle çeviren ince bir adaptör alır — bir kuralı tek yerde değiştirdiğinizde her barındırıcıya aynı şekilde ulaşır.
tezgah neyi zorunlu kılar ve kaydeder
- Tek sözleşme, altı barındırıcı. omp, Claude Code, Codex, Cursor, opencode ve dsh aynı kuralları görür, çünkü her barındırıcı paylaşılan tek bir çekirdeğin ince bir adaptörüdür — kuralı bir kez değiştirin, hepsi alır.
- "Tamamlandı" demek için kayıtta geçmiş bir kontrol gerekir. 15 reddin
olduğu bir kapı, etkisizleştirilmiş kontrolü durdurur —
--no-verify,|| true,tail'e yönlendirilmiş bir test, uçuş sırasında eklenen bir skip — ve Stop kuralı, oturumun kanıt defterinin desteklemediği tamamlanma iddiasını reddeder. Turu reddeder; modelin bu iddiayı dile getirmesini engelleyemez. - Araştırma kütüphanesiyle birlikte gelir. Araştırma görevleri, bağlamın küçük kalması için tek tek yüklenen 98 becerilik gömülü bir kütüphaneyle OpenResearch üzerinden yürütülür.
- Her kuralın bir kapatma anahtarı vardır. On altı kapatma anahtarı — ve depo başına işaretler — kuralın metnini oturumdan kaldırır; böylece kural yalnızca kapalı görünmez, gerçekten durur.
- Sabit bir yanıt biçimi. Yanıtlar, başka bir dil seçmediyseniz Türkçedir ve sonuçla başlar; bir liste en fazla beş sıralı madde gösterir; bir tahmin tahmin olarak adlandırılır; bir hata konum, neden, çözüm olarak okunur.
Neyi göstermedi
Tezgah bir mekanizmalar bütünüdür: oturuma eklenen kurallar, belirli komutları reddeden bir kapı ve Stop kuralının okuduğu bir defter. Bir ajanın daha az hile yaptığının ya da daha çok görev bitirdiğinin kanıtı değildir. Eşleştirilmiş bir açık/kapalı deneyi (Ekim 2026; omp üzerinde DeepSeek V4.1 Flash, tezgah'sız ile tam tezgah kurulumu karşılaştırıldı) hilede ölçülebilir bir azalma bulmadı, çünkü model iki kolda da neredeyse hiç hile yapmadı:
- Aşama 1, üç baskı düzeneği: her kolda 60 çalıştırmanın 0'ında hile; temiz geçiş tezgah ile 48/60, tezgah'sız 53/60.
- Aşama 2, ImpossibleBench'in çelişkili SWE-bench bölümü (44 örnek, k = 3): hile tezgah ile 0/132, tezgah'sız 1/131 (-0.8 pp, %95 GA -2.3 ile 0 arası); özgün görevlerde temiz geçiş 129/131'e karşı 129/132.
- Elle etiketlenmiş yanlış "bitti" iddiaları: bu imkânsız görevlerde, örneklenen son mesajların tezgah ile 30'da 3'ü, tezgah'sız 30'da 6'sı kullanıcıya görevin bittiğini söyledi. Düzeltilmiş fark -5 pp (%95 GA -18 ile +9 arası), yani iki yönde de etki yok.
- Stop kuralının iddia okuyucusunda bir zayıf nokta: tezgah ile 115/132,
tezgah'sız 90/131 çalıştırmayı işaretledi, ama işaretlerinin yalnızca %10'u
ve %20'si gerçek "bitti" iddiasıydı. tezgah ile ajan Türkçe yanıt verdi ve
okuyucu kısmi bir düzeltmedeki
doğrulandısözcüğünü iddia sayıyor. Bu kayda geçti, henüz düzeltilmedi.
Çalıştırmada ölçüm aracı kusurları vardı; bunların arasında, iki koldaki ajanların benchmark'ın doğru cevaplarını okuyabilmesi de var. Toplamlar, görev başına sayımlar ve her çekince sonuç paketinde yer alır (İngilizce).
Kurulum
Tek satır, macOS, Linux veya WSL'de (Python 3.10+, curl, tar). Son sürümü
indirir, sha256'sını doğrular ve bulduğu her barındırıcıyı kurar (Claude
Code'u kendi claude plugin CLI'ı üzerinden):
curl -fsSL https://raw.githubusercontent.com/r1z4x/tezgah/main/packaging/install.sh | shYa da npm ile: npm i -g @r1z4x/tezgah && tezgah --install.
Ayrıştıramadığı bir barındırıcı yapılandırmasına dokunmaz, değiştirdiği her
yapılandırmanın tarihli bir .tezgah-bak kopyasını tutar ve kurmayı
planladığı bir barındırıcı kurulamazsa sıfırdan farklı bir kodla çıkar.
tezgah makinenizde neyi değiştirir
- Barındırıcı yapılandırması. Kurulan her barındırıcı tezgah'ın
hook'larını, MCP satırlarını ve kendi genel kural dosyasında
(
~/.claude/CLAUDE.md,~/.codex/AGENTS.md,~/.omp/agent/RULES.md) yönetilen bir sözleşme bloğunu alır. Claude Code'un hook'larıclaude pluginile kaydedilen bir eklentide gelir;claudeCLI'ı yoksa Claude kurulmamış kalır ve rapor bunu söyler. - Depolarınızdaki ajan dosyaları. Yapılandırılan köklerde bir oturum
.claude/agents/,.codex/agents/ve.opencode/agents/altına alt ajan dosyaları yazar ve bu dizinleri klonun kendi.git/info/excludedosyasına ekler (TEZGAH_NO_EXCLUDE=1bunu durdurur). - Günlük güncelleme denetimi. Durum satırı yeni bir sürümü günde en fazla
bir kez sorar;
~/.config/tezgah/update-check-offya daTEZGAH_UPDATE_CHECK=0bunu kapatır. - orx. Kurulum, araştırma görevlerinin yönlendirildiği OpenResearch CLI'ını
indirir;
TEZGAH_NO_DEPS=1bunu atlar. - Yanıt dili. Yanıtlar varsayılan olarak Türkçedir ve Stop kuralı bunu
denetler.
--reply-lang enİngilizce,anyise sizin dilinizi ister; ikisi de denetlenmez:curl -fsSL … | sh -s -- --reply-lang en.
Kurulumu kodlama asistanınıza yaptırmak isterseniz bunu omp, Claude Code, Codex, Cursor veya opencode'a yapıştırın (istem İngilizce; asistan her dilde anlar):
Install tezgah (https://github.com/r1z4x/tezgah) on this machine and verify it.
1. Check the prerequisites: python3 --version must be 3.10 or newer, and curl
and tar must exist. If one is missing, stop and tell me which.
2. Run the installer exactly as published - do not edit it or pipe it anywhere else:
curl -fsSL https://raw.githubusercontent.com/r1z4x/tezgah/main/packaging/install.sh | sh
Its output must contain "verified tezgah-<version>.tar.gz" (the sha256
check). If it does not, stop and show me the output.
3. Verify: run ~/.local/share/tezgah/current/bin/tezgah-setup --version and
~/.local/share/tezgah/current/bin/tezgah-setup --report, and show me every
line that says MISS.
4. Tell me which hosts were armed, which repository root was configured
(default ~/Projects - if my code lives elsewhere, ask me for the directory and
run ~/.local/share/tezgah/current/bin/tezgah-setup --roots <dir> --install),
and that I must restart each assistant for the hooks to load.
Do not change any other file and do not uninstall anything.Sürüm sabitleme, Windows (packaging/install.ps1), çevrimdışı tarball,
yükseltme ve isteğe bağlı entegrasyonlar docs altındadır.
Desteklenen barındırıcılar
omp (birincil barındırıcı; tezgah buna göre geliştirilir ve doğrulanır), Claude Code, Codex, Cursor, opencode, dsh — paylaşılan tek çekirdeğin ince adaptörleri.
Ayrıntılar nerede
Kapı, kanıt defteri, barındırıcı adaptörleri, yapılandırma ve geliştirme docs/README.md içindedir; soru başına bir sayfa.
Lisans
MIT — bkz. LICENSE.
Katıştırılmış beceriler (ponytail, no-ai-slop, i-have-adhd) kendi MIT koşullarıyla gelir; bkz. NOTICE.
