Claude'dan bir `pi` oturumu yönetmek (iki tarafta da tmux)-

§ 01Claude'dan bir `pi` oturumu yönetmek (iki tarafta da tmux)

Zihindeki model: iki taraf, tek ortak `/tmp`

  ┌─ pi tarafı (işçi) ──────────┐         ┌─ Claude tarafı (gözetmen) ──┐  │ tmux oturumu "pi-loop"      │         │ Claude (Bash aracı)         │  │   └ exec pi  ← brief.md     │         │   ├ watch.sh (arka planda)  │  │       working tree'i düzenler│        │   └ opsiyonel: kendi tmux    │  │       build/test çalıştırır  │        │       paneli (claude-target) │  └──────────────┬──────────────┘         └──────────────┬──────────────┘                 │                                        │                 │   ortak dosya sistemi /tmp/<session>/  │                 └────────────►  PING  ◄───────────────────┘                                 summary.md                                 brief.md / ping.log / claude-target

pi tarafı: pi tmux'un _içinde_ çalışır

tmux new-session -d -s "$SESSION" -x 220 -y 50 \  "cd '$REPO' && set -a && [ -f '$KEY_ENV' ] && . '$KEY_ENV'; set +a \   && exec pi 'Read @$STATE/brief.md and execute it. ... ping me per the protocol.'"

• -d yani detached: pi’ye bağlı bir istemci yok. Claude’un Bash aracıona asla takılıp kalmaz.
• -x 220 -y 50 cömert bir pane geometrisi sabitler ki kimse bağlıdeğilken pi’nin TUI’si tuhaf sarmasın (detached bir oturum yoksa 80×24’edüşer).
• API anahtarı oturumun içinde source edilir, Claude’un kabuğunda değil.Her tmux komutu yeni, login’e yakın bir kabuk açar ve Bash aracının ortamıDEEPSEEK_API_KEY taşımaz. set -a; . $KEY_ENV; set +a anahtarı sadece opane içinde export eder. Varsayılan anahtar dosyası~/.myserver/deepseek.env (PI_KEY_ENV ile değiştirilebilir). Bu dosyayıasla echo etme.
• exec pi kabuğun yerine pi’yi koyar, böylece oturum tam olarak piçıktığında ölür. watch.sh’in “ping atmadan bitti” durumunuyakalayabilmesini sağlayan şey budur.

1. Brief’ini $STATE/brief.md’ye kopyalar ve sonuna ping protokolünü ve sertkorkulukları ekler (asla commit/push/checkout/deploy yapma, asla prodSSH atma, her değişiklikten sonra doğrula). pi’nin talimatı brief dosyasıolduğu için korkuluklar görevle birlikte gider.
2. Aynı isimdeki eski oturumu öldürür, sonra detached bir oturum başlatır: Önemli tmux ayrıntıları:

Claude tarafı: bir dosyayı izle, saati yoklama

bash .claude/skills/pi-loop/scripts/watch.sh pi-loop   # run_in_background: true

1. Önce rm -f $STATE/PING. Böylece bu kurulum yalnızca bir sonraki ping’detetiklenir, eski bir ping’le asla.
2. until [ -f $STATE/PING ] || ! tmux has-session -t $SESSION döngüsü kurar.Yani iki koşuldan birinde uyanır: pi ping attı, ya da pi’nin oturumukayboldu (çökme veya ping atmadan bitme).
3. Çıkarken summary.md’yi yazdırır (yoksa “ping atmadan bitti” der).

Claude tarafında her ping döngüsü

1. İzleyicinin çıktısını (summary.md) ve pi’nin düzenlemeleri içingit -C <repo> diff’i oku.
2. Eleştirel doğrula: pi API ve sembol uydurur, gerçekten var olduklarınıteyit et.
3. Bağımsız olarak yeniden doğrula: cd web && ./node_modules/.bin/vue-tsc --noEmit, CGO_ENABLED=0 go build ./..., ilgili go test.
4. pi’ye bir takip mesajı enjekte et (aşağıya bak) ya da işi sarıp topla.
5. Bir sonraki ping için watch.sh’i yeniden kur.

Bir ping aradaki boşluğu nasıl geçer (`pi-notify.sh`)

tmux send-keys -t "$TARGET" "[pi-loop:...] <msg> — review summary.md + diff" Enter

• Yöntem 1: izleme dosyası (her zaman). ping.log’a ekler, sonra touch $STATE/PING. watch.sh’in tıkanmasını çözen tek dosya oluşturma bu. İkitaraf /tmp’yi paylaştığı için Claude nerede çalışırsa çalışsın işler.
• Yöntem 2: doğrudan tmux enjeksiyonu (yalnızca Claude da tmux içindeyse).$STATE/claude-target Claude’un kendi session:window.pane’ini tutuyorsa,pi-notify şunu yapar: Yani pi’nin ping’ini doğrudan Claude’un girdisine bir sohbet mesajı olarakyazar. Hiçbir izleyici kurulu olmasa bile “pi sohbeti arar”. En iyi çabaprensibiyle çalışır; hedef pane yoksa pi’yi asla başarısız etmez.

Doğrudan enjeksiyonu açmak (Claude'un tmux'unun önem taşıdığı tek yer)

if [ -n "$TMUX" ]; then  tmux display-message -p '#S:#I.#P' > /tmp/<session>/claude-targetelse  echo "Claude tmux içinde değil, sadece izleme-dosyası yöntemi."fi

Çalışan bir pi oturumuna iş enjekte etmek

tmux send-keys -t pi-loop "her düzeltmede ping atmayı bırak; son bir tarama yapıp tek ping at" Enter

Canlı izleme / bağlanma (insan)

tmux attach -t pi-loop      # pi'yi gerçek zamanlı izletmux ls                     # oturumları listeletmux kill-session -t pi-loop  # pi'yi durdur (Claude istenmedikçe boşta/bağlı bırakır)

Bu kuruluma özgü tmux tuzakları

• İki ayrı kabuk, tek tmux sunucusu. Koordinasyon ortam mirası üzerindendeğil, ortak /tmp üzerinden olur. $TMUX, $DEEPSEEK_API_KEY ya da PATHoynamalarının Claude’un kabuğundan pi paneline geçmesini bekleme. Anahtar tamda bu yüzden oturumun içinde tekrar source ediliyor.
• Bayat PING. watch.sh kurulurken onu siler; nöbetçiyi elle kontroledersen, kalan bir PING yeni bir izleyiciyi anında tetikler.
• exec pi canlılığı oturuma bağlar. pi tıkanmış bir sağlayıcı çağrısındatakılırsa pane sonsuza dek “Working…” gösterir, has-session hâlâ true dönerve hiç ping gelmez; izleyici sonsuza dek bekler. Uzun yedek uyandırmanınkoruduğu durum bu; pane’i tekrar kontrol et ve kill-session + yenidenbaşlatmayı düşün.
• Geometri. Detached oturumlar 80×24’e düşer; pi’nin TUI çıktısınınattach/capture-pane içinde okunabilir olması için 220×50’ye zorluyoruz.
• Karışık working tree. pi’nin düzenlemeleri başka commit’lenmemiş işlerinyanına iner. summary.md ve adı geçen dosyaların hedefli git diff’iyleayrıştır. pi asla commit atmaz; commit/deploy eden tek taraf Claude’dur(kullanıcı onayıyla).

Ayrıca bakınız

• .claude/skills/pi-loop/SKILL.md: Claude’un izlediği prosedür.
• .claude/skills/pi-loop/scripts/{launch,watch,pi-notify}.sh: kaynak.
• Bellek: feedback_tmux_means_green.md, reference_deepseek_key.md,feedback_never_kill_running_pi.md.