Sorun giderme

Belirtiler aşağıda sırasıyla verilmiştir; sayfada kendinizinkini arayın. herdr plugin kaynağından Os { NotFound } · update çıktısında "not currently on a branch" yazıyor · tailscale serve failed · yanıt vermiyor (hizmet başlamıyor) · telefon URL'yi açamıyor · sayfa yükleniyor ancak boş kalıyor (boş sayfa, 403) · parola istemi yanıtınızı kabul etmiyor · anlık bildirim yok · yeniden başlatma sonrasında kayboldu · bir bölme dar kalıyor · Collie bir tmux penceresi açmayı reddediyor · tmux list: output did not parse · herdr plugin list eski sürümü gösteriyor · yeniden derleme sonrasında eski UI · Herdr içinde bir makine kaydettim ve telefon bunu göstermiyor · telefondan başlatılan bir güncelleme hazırlık aşamasında takılı kalıyor · macOS üzerinde bir telefon güncellemesi Collie'yi yüklenmemiş durumda bırakıyor · macOS üzerinde collie status "loaded, not running" diyor · bir bölmede prompt-cache çipi görünmüyor · bir Kiro bölmesinin History görünümü boş açılıyor · bir bölmede Sohbet veya Geçmiş yok · yeni bir Codex bölmesi henüz geçmişi olmadığını söylüyor · telefon Collie'nin aracının göstermediği bir ekranı okuyamadığını söylüyor · gönderme 3 kez başarısız oldu ve telefon bir rapor öneriyor · New sayfasında bir ajan soluk renkte görünüyor · Start klasör olmadığını söylüyor veya onaylayamadığını bildiriyor · walky talky: gönderme reddedildi, "run this inside a pane" · walky talky: ileti gelen kutusunda bekliyor ve yazılmadı · walky talky: "no log record on this machine" · walky talky: beceri güncel değil · kalıcı bir ajan görünmüyor veya Unreachable diyor.

herdr plugin …, Error: Os { code: 2, kind: NotFound, message: "No such file or directory" } ile başarısız oluyor (eklenti kurulumu başarısız, eylem çağırma başarısız). Bu değil bir Collie sorunu değildir; Herdr sunucusu çalışmıyor anlamına gelir, bu yüzden CLI'ı denetim soketine (~/.config/herdr/herdr.sock) erişemez. İpucu ham Os {…} hatasıdır: erişilebilir bir sunucu yol/manifest sorunlarına yapılandırılmış JSON ile yanıt verir (örn. plugin_manifest_not_found), bu nedenle yalın bir Os { NotFound }, Collie veya yolunuz incelenmeden önceki başarısız bir soket bağlantısıdır. Sunucuyla iletişim kuran her alt komutu (link, install, action invoke) etkiler; oysa herdr plugin --help çalışmaya devam eder (soketi asla açmaz). Çözüm: önce Herdr'ı başlatın (herdr server & veya doğrudan Herdr TUI'sini açın; sunucuyu başlatır), ls ~/.config/herdr/herdr.sock dosyasının artık mevcut olduğunu doğrulayın, ardından kurulumu yeniden deneyin. herdr plugin list hızlı bir yoklamadır: aynı hatayı verirse sunucu kapalıdır.

update, You are not currently on a branch ile başarısız oluyor. 0.23.1 öncesinde yapılmış bir GitHub kurulumu (#63): herdr plugin install klonlamak yerine ayrılır, bu yüzden eski update içinde git pull yapılacak bir dal yoktu. Düzeltme, onardığı çalışma kopyasının içinde gelir; bu nedenle geçerli olması için bir kez yeniden kurulum gerekir: Bu işlem "Şu anda bir dalda değilsiniz" ile başarısız olursa gereken üç komutu içerir.

start, note: tailscale serve failed çıktısını veriyor. Collie'nin kendisinde sorun yok (127.0.0.1 üzerinde hâlâ çalışıyor); yalnızca tailnet girişi başlamadı ve tailscale'in kendi hatası terminalde notun üzerinde yer alıyor. Olası nedenler: kullanıcınız Tailscale operatörü değildir (sudo tailscale set --operator=$USER), düğümün oturumu kapatılmıştır (tailscale up) veya (Headscale / .internal tailnet etki alanlarında) HTTPS sertifikaları mevcut değildir; COLLIE_SERVE_MODE=http tam olarak bunun içindir: bunu .env içinde ayarlayın, ardından bin/collie restart çalıştırın. tailscale serve status ile doğrulayın.

serve, HTTPS certificates are not enabled on this tailnet diyor. Hiçbir şey yayımlanmadı ve hiçbir şey beklemiyor. yönetici konsolu sayfasını açın, "Enable HTTPS" seçeneğini etkinleştirin, ardından collie serve komutunu tekrar çalıştırın. Headscale / .internal etki alanlarında etkinleştirilecek sertifika yoktur; bunun yerine COLLIE_SERVE_MODE=http kullanın.

Başlık ⚠ Collie isn't answering on :8787 yet gösteriyor (hizmet başlamıyor, bağlantı reddedildi). Hizmet başlatıldı ancak HTTP sunucusu yoklamaya yanıt vermiyor. Nedenini görmek için önce birimi (systemctl --user status collie), ardından bin/collie logs (veya canlı izlemek için journalctl --user -u collie -f) komutunu kontrol edin: genellikle bağlantı noktası zaten kullanımdadır (.env içinde COLLIE_PORT değerini ayarlayın, ardından yeni bağlantı noktasına karşı tailscale serve komutunu da tekrar çalıştıran bin/collie restart komutunu yürütün) veya ilk derleme başarısız olmuştur (günlük bunu belirtir; sorunu çözüp bin/collie build çalıştırın). Birim her 5 saniyede bir otomatik olarak yeniden başlar, bu nedenle neden giderildiğinde genellikle kendiliğinden geri gelir.

Telefon tailnet URL'sini açamıyor. Listedeki adımları sırayla uygulayın: (1) telefonda Tailscale uygulaması çalışıyor ve ana bilgisayarla aynı tailnet'e bağlı; (2) başlıktaki tailnet URL'sini (bin/collie url) açıyorsunuz, local olanı değil; http://127.0.0.1:8787 yalnızca ana bilgisayarın kendisinde çalışır; (3) tailnet'inizin DNS ayarlarında MagicDNS etkindir (URL bir MagicDNS adıdır); (4) ana bilgisayar çevrimiçidir; ana bilgisayarda tailscale status kontrolü yapın veya telefonun Tailscale uygulamasından ana bilgisayara ping atın; (5) tailnet politikanız bu düğüme bir eşin bağlanmasına gerçekten izin veriyor; izin vermiyorsa başlık artık bunu tailnet satırının altında belirtir ve başka hiçbir şey belirtmez: ön kapı doğru şekilde yayımlanmıştır, sertifika geçerlidir ve ana bilgisayarın kendisinden yapılan curl 200 döner, çünkü geri döngü paket filtresine asla uğramaz. İki durum bunu özellikle yanıltıcı hale getirir: tailscale ping başarılı oluyor (bulma ping'leri ACL'leri atlar) ve engellenen trafik reddedilmek yerine düşürülür, bu yüzden telefon yanıt vermez ve "sunucu kapalı" gibi görünür. Bunu ACL politikanızda düzeltin (Tailscale'de <https://login.tailscale.com/admin/acls>; Headscale'de politika dosyanız). Bu denetim elden gelen en iyi çabayla yapılır ve kasıtlı olarak kesinlik taşımaz: yalnızca bu düğümün filtresi hiçbir şey kabul ettiğinde uyarı verir (bu da tailnet'e henüz başka bir cihazın katılmadığı anlamına gelebilir) ve emin olamadığı durumlarda sessiz kalır.

Sayfa yükleniyor fakat boş kalıyor (boş sayfa, beyaz ekran); API çağrıları başarısız oluyor 403 cross-origin rejected. Collie'ye beklemediği bir kaynaktan erişiyorsunuz: özel bir etki alanı veya Host üstbilgisini yeniden yazan bir proxy. COLLIE_ALLOWED_ORIGINS ile tam genel kaynağa izin verin (bkz. Yapılandırma) veya proxy'nin Host üstbilgisini değiştirmeden iletmesini sağlayın (docs/deployment.md içindeki dördüncü proxy gereksinimi).

Bir sudo (veya SSH parola ifadesi ya da gpg) istemi yanıtınızı kabul etmiyor. Klavyenin üstündeki eylemler satırında Gönder'i değil, Yaz öğesini kullanın. Gönder, Enter'a basmadan önce ekrandan geri okuyarak yazdığı şeyi doğrular (#34), parola istemi ise yankıyı kapattığından geri okunacak bir şey kalmaz; Yaz tuş vuruşlarınızı Enter dahil doğrudan bölmeye gönderir. Yaz içine yazdığınız hiçbir şey saklanmaz, bir taslağa yansıtılmaz veya daha sonra geri yüklenmez; Collie bir parola istemi algıladığı anda saklanan taslağı da bırakır (#103).

Anlık bildirimler gelmiyor. Elle bir tane tetikleyin: bin/collie push-test. Komutun ayırt ettiği sırayla üç neden: push devre dışı olduğunu söyler (anahtarlar köprüye hiç ulaşmadı; push-keys komutunu çalıştırıp yeniden başlatın, bkz. Web Push); abone olunan cihaz bulunmadığını söyler (bu telefon Ayarlar → Uyarılar bölümünden bunları hiç etkinleştirmedi); veya gönderildiğini bildirir ancak hiçbir şey ulaşmaz (telefon güvenli bir bağlam olmayan düz HTTP kaynaklı bir adrestedir; Ayarlar bunu insecure olarak işaretler).

Yeniden başlatmanın ardından Collie kayboluyor. Linux üzerinde bu durum neredeyse her zaman lingering kaynaklıdır; bu nedenle loginctl enable-linger $USER çalıştırın (Yeniden başlatmalardan sonra çalışmayı sürdürme). macOS üzerinde launchd aracısı login anında başlar; bu yüzden gerçekten oturum açtığınızı (oturum açma penceresinde kalmadığınızı) ve aracının yüklendiğini kontrol edin: launchctl print gui/$(id -u)/herdr.collie.

Bir panelin terminali dar kalıyor ve içindeki tam ekran uygulama sıkışıyor (Copilot CLI, top, aynanın geri kalanı boş kalırken şerit halinde çizilen herhangi bir TUI). Panelin terminali bu kadar dardır ve Collie bunu birebir yansıtır. Bir Herdr panelinin genişliği, sekmenin bölme ızgarasındaki dikdörtgeninden gelir; dolayısıyla sekmeyi paylaşan bir panel sütunların bir kısmını alır. Herdr panel geometrisini yalnızca masaüstü istemcisi bağlıyken uygular (herdr#1709): bağlı hiçbir şey yokken bir bölmeyi kapatmak, geriye kalan paneli eski dar genişlikte takılı bırakır; soket üzerinden pane.zoom ve pane.resize da bunu hareket ettirmez. Collie bunu kendi tarafından düzeltemez; panel geometrisini hiçbir şekilde yazmaz (ADR 0031: telefon, operatör terminalini yalnızca Terminalde göster dokunuşunda hareket ettirir). Bu duruma özgü hiçbir şey bir uygulamaya bağlı değildir: 54 sütunluk bir panelde top tamamen aynı görünür. Ölçmek için panelde tput cols çalıştırın. Gerçek genişlik budur ve herdr pane layout bildirdiği değerle uyuşmayabilir. Düzeltmek için bir Herdr istemcisi bağlayın, ardından orada paneli yakınlaştırın veya yeniden boyutlandırın (bir şey bağlandıktan sonra herdr pane zoom <pane-id> --on terminali hareket ettirir) ya da paneli kapatıp yenisini açın (#167).

Collie bir tmux penceresi açmayı reddediyor (telefonun yeni sekme işlemi window-size belirterek reddediliyor). İstekte bir hata yok: 3.7 altındaki tmux sürümlerinde, sunucunun window-size değeri manual iken pencere açmak tüm sunucuyu çökertebilir (tmux #4849, 3.7 sürümünde düzeltildi) ve çöken sunucu tüm pencereleri beraberinde götürür. Collie bunun yerine işlemi reddeder ve algıladığı tmux sürümünü belirtir. Çözüm, yazdırdığı satırdır: o sunucuda tmux set -g window-size latest çalıştırmak veya tmux 3.7 sürümüne geçmek. Başka hiçbir şey etkilenmez: bu panellerdeki diğer tüm işlemler çalışmaya devam eder (Gereksinimler aynı uyarıyı taşır).

Collie tmux list: output did not parse günlüğünü tutuyor ve gösterge paneli boş görünüyor. Bu bir kilitlenme değil: bazı tmux sürümleri (3.6b değil, 3.4), bir -F listelemesinden çıkarken bu bağdaştırıcının okuduğu ayırıcıyı kaçış karakteriyle yazar. Collie artık her iki biçimi de okur, bu nedenle sıfır satır olarak ayrıştırılan bir listeleme boş bir herd olarak saklanmak yerine bir mux hatası olarak bildirilir; hata satırı tmux sürümünü ve kaç satır gördüğünü belirtir. İkinci bir neden yerel ayardı: UTF-8 yerel ayarı olmadan başlatıldığında (minimal bir konteyner, bir systemd birimi), tmux bu ayırıcıyı kaçış karakteriyle yazmak yerine _ ile değiştirir. Collie artık her tmux komutunu -u ile çalıştırır, bu nedenle listeleme artık LANG veya LC_ALL değişkenine bağımlı değildir. Bununla karşılaşmaya devam ederseniz tmux -V sürümünü not edin ve bir sorun kaydı açın; düzeltme .env dosyanıza değil, bağdaştırıcıya aittir.

Bir update sonrasında herdr plugin list eski sürümü gösteriyor. Beklenen bir durumdur: Herdr, yükleme veya bağlama sırasında okuduğu bildirimi önbelleğe alır. Neyin çalıştığına dair kesin bilgi altbilgideki derleme damgası veya bin/collie version değeridir. Bağlantılı bir klon için update işlemi yeniden bağlama yapar ve kendi kendini onarır (herdr plugin link "$(pwd)" ile zorlayın); Herdr ≥0.8.0 sürümlerinde bildirim zaten diskten yeniden okunur.

Yeniden derlemeden sonra telefon eski arayüzü gösteriyor. Bir PWA'nın service worker önbelleği kaynak (origin) başınadır; bu nedenle Collie'ye iki farklı kaynaktan (özel bir alan adı ve ham host:8787) erişmek size her biri kendi paketini önbelleğe alan iki ayrı kurulum verir. Altbilgideki derleme damgası (vX.Y.Z · sha · time), çalıştırdığınız paketi gösterir; Collie sunduğu sürümü X-Collie-Build üstbilgisi ve /api/config üzerinden bildirir. Bir uyumsuzluk durumunda altbilgi "yeni derleme — güncellemek için dokunun." seçeneğini sunar. Aksi takdirde PWA'yı birkaç kez yeniden açın (SW otomatik güncellenir) veya o kaynağın site verilerini temizleyin. En iyi uygulama: Tek bir HTTPS kaynağı seçin ve ona bağlı kalın. (Düz HTTP üzerinden SW kaydolamaz: her zaman güncel kalır fakat PWA özellikleri bulunmaz.)

Herdr'da bir makine kaydettim ancak telefon bunu göstermiyor. Beklenen durum. Herdr'ın kayıtlı makineleri kendi istemcisinin listesidir, crew ise Collie'nin kendi listesidir; iki liste de diğerini beslemez. Telefondan o makineye erişmek için makineyi kaydedin: lead üzerinde collie crew add <ssh-host>, ardından lead üzerinde collie restart ve bağlantıyı kontrol etmek için collie crew status. Herdr'da bir makine eklemek veya kaldırmak crew içinde hiçbir şeyi değiştirmez (Herdr makineleri ve ekip).

Bir bölmede prompt-cache çipi görünmüyor. Üç durumdan biridir ve collie doctor bunları birbirinden ayırır. Bölmenin koşumunda, integration-<agent> ve journal-roots satırlarının adlandırdığı bir günlük bağdaştırıcısı yoktur. Bölme hiçbir zaman bir oturum bildirmemiştir; bunu agent-sessions satırı bölme kimliğine göre listeler. Ya da aracı henüz bir sıra almamıştır ve bu bir hata değildir: ölçülmeden önce hiçbir şey gösterilmez, dolayısıyla çip aracının ilk yanıtında görünür. Sağlayıcısı önbellek ömrü yayımlamayan bir koşum da hiçbir şey göstermez ve cache-claims bu derlemenin sunduğu her kuralı listeler.

Bir Kiro bölmesinin History görünümü boş açılıyor. Bölmenin Kiro'sunun bir oturum kilidi tuttuğunu kontrol edin:

cat ~/.kiro/sessions/*/*/.lock

Herdr bir Kiro bölmesi için oturum adı belirtmez, bu nedenle Collie oturumu çalışan Kiro'nun tuttuğu kilitten bulur. Bu yalnızca bir bölmenin ön plan işlemlerini listeleyen tek çoğullayıcı olan Herdr üzerinde ve yalnızca orada tam olarak bir Kiro işlemi çalıştığında işe yarar. Aksi takdirde History, bölmenin aracı oturumu olmadığını bildirir.

Collie; --v3 veya --agent-engine v3 ile ya da Kiro'nun kendi ayarlarında motor olarak V3 seçilerek başlatılan Kiro V3 oturumlarını okur, bu nedenle o bölmede Kiro'yu bu şekilde yeniden başlatın. Kiro'nun kurulacak bir Herdr kancası yoktur. Oturumları başka bir yerdeyse kiro_root ayarını yapın, ardından collie restart çalıştırın.

Sohbet beklediğiniz yerde bir bölme terminali gösteriyor. Bir agent paneli için varsayılan Sohbet'tir, bu nedenle iki durumdan biri geçerlidir. Bu cihaz daha önce terminali seçmiştir: panelin ⋮ menüsünü açın ve Sohbet görünümü üzerine dokunun. Veya panelde okunacak bir oturum ya da günlük yoktur. Yeni bir panel "Başlamak için bir mesaj gönderin" ile Sohbet'i gösterir ve ilk turu okunacak hiçbir şey olmadan bittiğinde ya da önce bir soru sorduğunda terminale geri döner; menü satırı hangi parçanın eksik olduğunu belirtir ve bir sonraki girdi adımları içerir.

Bir bölmede Chat veya History yok ve ⋮ menüsü bölmenin hiçbir oturum adı belirtmediğini söylüyor. Chat ve History aracının oturum günlüğünü okur ve Collie bu günlüğü yalnızca aracı oturumunu multiplexer üzerinden bildirdiğinde bulur. Herdr üzerinde bu bildirim aracının kendi entegrasyonundan gelir; bu nedenle eksik veya eski bir entegrasyon başka hiçbir belirti vermeden her ikisini de gizler. collie doctor bölmeyi agent-sessions altında, düzeltmeyi ise integration-<agent> altında adlandırır.

1. 01
   herdr integration status komutunu çalıştırın. Aracı not installed veya outdated ise herdr integration install <agent> komutunu çalıştırın. Oh My Pi omp ve pi pi durumundadır: her birinin kendisine ait olana ihtiyacı vardır.
2. 02
   O bölmedeki aracıyı yeniden başlatın. Bir aracı kancasını başlarken yükler; bu nedenle yükleme sırasında çalışmakta olan bir aracı hiçbir şey bildirmemeye devam eder.
3. 03
   Kanca güncelse ve yeniden başlatılan bir bölme hâlâ hiçbir şey bildirmiyorsa, aracının başka bir aracının açtığı bir kabuktan başlatılıp başlatılmadığını kontrol edin. OMPCODE=1 üst aracıdan devralındığında Oh My Pi kancası sessiz kalır. Yeni bir uçbirimden başlatın.

tmux, zellij ve tern üzerinde yalnızca Claude Code, Collie'nin beacon kancaları aracılığıyla bir oturum bildirir. collie hooks install claude (Collie kancaları Claude'un kendi ayarlarına yazar) komutunu çalıştırın. Diğer ajanların orada Sohbeti veya Geçmişi yoktur.

Yeni bir Codex bölmesi henüz geçmişi olmadığını söylüyor. İlk sırasına kadar beklenen bir durumdur. Codex oturumunu Herdr'a başlatıldığında değil, yalnızca ilk prompt gönderildiğinde bildirir; bu nedenle yeni bir bölmenin o zamana kadar oturumu ve Geçmiş (History) bağlantısı olmaz. collie doctor böyle bir bölmeyi agent-sessions altında henüz bildirilmedi olarak listeler ve bunu bir hata saymaz. Codex yanıt verdikten sonra da bu not duruyorsa Codex içinde /hooks açın. Hook'ları değiştiğinde Codex bunları incelemenizi ister; "Continue without trusting" seçeneği herdr integration status hâlâ güncel olduğunu belirtirken Herdr hook'unu devre dışı bırakır. Hook'u orada onaylayın veya herdr integration install codex çalıştırıp yeni bir oturum başlatın.

Masaüstündeki aracı normal prompt'unu gösterirken telefon Collie'nin bir iletişim kutusunu okuyamadığını söylüyor veya gönderilen metin giriş kutusuna ulaşmıyor. Collie ekranı yanlış okudu; bu durum genellikle aracın ekranı çizme biçimini değiştirmesinden kaynaklanır. Lütfen ekranın ham metnini içeren bir sorun kaydı (issue) açın; bu metin bir ekran görüntüsünün gösteremediği ayrıntıları (Collie'nin okuduğu renkleri ve soluk metinleri) gösterir. Bölme kimliğini herdr pane list ile bulun, ardından şunu çalıştırın:

herdr pane read <pane-id> --source recent --lines 200 --format ansi > pane.txt

telefon sorunu göstermeye devam ederken çalıştırın ve pane.txt dosyasını aracının sürümüyle (claude --version, codex --version vb.) birlikte ekleyin. Dosya terminalin metnini içerir; bu nedenle önce dosyayı okuyun ve gizli kalması gereken bilgileri temizleyin.

Gönderme 3 kez başarısız oldu ve telefon bir rapor öneriyor. Bir bölmede art arda üç gönderme işlemi Collie'ye işaret eden bir nedenle başarısız oldu: giriş kutusunu okuyamadı veya yazamadı, metin girdi ve Enter takip etmedi veya gönderme işleminin takibini kaybetti. Sizi koruyan bir ret (kutuda bir taslak, çalışan bir tur, açık bir iletişim kutusu) sayılmaz. Kartta Report öğesine dokunun. Sayfa, hiçbir şey çıkmadan önce sorunun tamamını gösterir: Collie ve aracı sürümleri, çoğullayıcı ve her başarısız göndermenin kodları. Yazdıklarımı dahil et veya Ekranı dahil et açmadığınız sürece yazdığınız hiçbir metni ve ekranı tutmaz. Ekran, bilinen gizli kalıplar maskelenmiş olarak bölmenin son 40 satırıdır; sorun herkese açık olduğundan yine de okuyun. Open on GitHub doldurulmuş formu tarayıcınızda kendi GitHub hesabınız altında açar ve Copy report aynı metni kopyalar. Aynı imza satırına sahip bir sorun bulmak için önce Zaten bildirildi mi? öğesine dokunun. Bölme menüsü ve Ayarlar → Sistem aynı sayfayı istediğiniz zaman açar. Çarpı işareti, bir gönderme işlemi tekrar çalışana kadar o bölmedeki kartı kapatır. Bir ekip üyesinin bölmesi henüz bir rapor sunmaz; yukarıdaki adımları kullanın.

Telefondan başlatılan bir güncelleme hazırlama aşamasında kalıyor. 1.6.0 sürümüne kadarki Collie sürümlerinde, telefonda dokunulan bir güncelleme yeni sürümü hazırlayabilir (stage) ve ardından durabilirdi: değişimi gerçekleştiren çalıştırıcı hiçbir zaman başlatılmazdı, servis eski sürümü sunmaya devam ederdi ve çalıştırma kaydı kilit tutulu halde staging durumunda kalırdı. Göstergesi bir arada gerçekleşen üç olgudur: collie update --status, staging (veya on dakika geçtikten sonra interrupted — the updater is gone) bildirir, yeni sürümün sürüm dizini versions/ altında bulunur ve ~/.config/collie/collie.log konumundaki çalıştırıcı günlüğü 0 bayttır. Aynı makinedeki bir kabukta yazılan collie update her zaman çalışırdı; bu da aynı kusurun diğer taraftan görünüşüdür. Sonraki sürümden itibaren düzeltilmiştir: devir işlemi artık çalıştırıcıyı onaylaması için kullanıcı yöneticisini bekler ve reddedilen bir devir yöneticinin kendi gerekçesiyle bir hata olarak bildirilir.

Zaten takılmış bir makineyi temizlemek için on dakika hiçbir şey yapmayın: güncelleyicisi kaybolmuş bir çalıştırma, son geçişinden on dakika sonra yeniden denemeyi engellemeyi bırakır ve sonraki dokunuş ilerler. Hemen temizlemek için kaydı, kilidi ve hazırlama ilerleme dosyasını silin, ardından --status çıktısını kontrol edin:

collie update --status            # note the pid it names
ps -p <pid> -o command=           # empty output: the updater really is gone
rm -f ~/.local/state/collie/update.json ~/.local/state/collie/update.lock
rm -f ~/.local/state/collie/update-staging-*.log
collie update --status            # "no update has run on this install yet"

Eski bir çalıştırmayı temizleyen bir komut yoktur ve bu üç dosya, durmuş bir hazırlamanın geride bıraktığı durumun tamamıdır. Soneke sahip bir örnek bunları ~/.local/state/collie-<name>/ içinde tutar. Bir güncelleme fiilen çalışırken bunları Asla silmeyin ve önce pid değerini kontrol edin: kilidini kaldırdığınız canlı bir güncelleyici, onu koruyan hiçbir şey olmadan current durumuna geçecektir. versions/ dizinine dokunmayın. Yarı hazırlanmış sürüm dizini zararsızdır, yeniden deneme tekrar bunun içine inşa edilir ve saklama temizliği artık ihtiyaç duymadığı şeyleri kaldırır.

macOS üzerinde bir telefon güncellemesi Collie'yi yüklenmemiş durumda bırakıyor. Bunu Mac üzerinde çalıştırın:

collie restart

1.8.x sürümüne kadarki Collie sürümlerinde telefondan dokunulan bir güncelleme launchd aracısını durdurabilir ve bir daha asla yüklemeyebilirdi; bu nedenle telefon hizmeti kaybeder ve launchctl print gui/$(id -u)/herdr.collie hiçbir şey bulamazdı. Çalıştırıcı, aracının işlem grubunu paylaşıyordu ve aracıyı yeniden başlatmak onu yarı yolda sonlandırıyordu. collie restart komutu aracının plist dosyasını yeniden yazar ve yükler. 1.9.0 sürümünden itibaren köprü, çalıştırıcıyı kendi işlem oturumunda başlatır. Bundan sonra telefondan yapılan bir güncelleme aracıyı yine de kaldırırsa aynı komutu çalıştırın ve #213 üzerine bir not ekleyin.

macOS'te collie start tamamlanıyor ancak collie status "loaded, not running" diyor. launchd işi yüklendi ve hiçbir işlem çalışmıyor, bu yüzden günlük boş. İşi elle başlatın:

launchctl kickstart gui/$(id -u)/herdr.collie
collie status

Sonsözlü bir örneğin kendi etiketi vardır, örneğin herdr.collie-next. 1.17.0 sürümünden itibaren collie start ve collie restart bu adımı sizin yerinize yapar ve hiçbir işlem görünmediğinde bu komutla bir uyarı yazdırır. İşi bundan sonra da "loaded, not running" durumunda kalırsa, günlüğü collie logs ile okuyun ve ardından #213 üzerine bir not ekleyin.

New sayfasında bir ajan soluk renkte görünüyor. Gerekçe, adının ardından parantez içinde belirtilir. "not installed", makinenin ajanın komutunu giriş kabuğunuzun kullandığı PATH üzerinde bulamadığı anlamına gelir. O makinedeki bir giriş kabuğunda bash -lc 'command -v claude' (veya ajanın kendi adını) çalıştırın. Hiçbir şey yazdırmazsa ajanı oraya yükleyin veya kabuğunuzun giriş dosyasında onu PATH yoluna ekleyen satırı düzeltin ve sayfayı yeniden açın. Bir crew üzerinde, seçtiğiniz makineyi kontrol edin: her member kendi diskine bakar. "this machine runs an older Collie", o member'ı güncellemeniz gerektiği anlamına gelir (Bir makinede bir şey başlatma). "needs Herdr" ve bir makinenin adını içeren "only on" ifadeleri ajana değil, Yeni worktree anahtarına aittir.

Start "There is no folder … on this machine" veya "could not confirm the start" diyor. İlki, klasörün başlatmayı yürüten makinede bulunmadığı, bu nedenle hiçbir şeyin başlatılmadığı anlamına gelir. Başında / veya ~ bulunmayan bir ad, ev dizininizin altındaki bir klasördür; dolayısıyla projects, ~/projects anlamına gelir. Klasörü oluşturun veya Recent listesinden birini seçin. İkincisi, telefonun yanıtı kaybettiği anlamına gelir. Önce gösterge paneline bakın, çünkü bölme zaten var olabilir. Tekrar deneyin aynı isteği gönderir ve asla ikinci bir bölme açmaz (Telefondan bir ajan veya kabuk başlatın).

Telsiz

En çok altı walky talky belirtisi ortaya çıkar. Her birinin nedenini gösteren bir komut vardır (Telsiz).

collie walky send "bunu bir panelin içinde çalıştırın veya telefondan gönderin" uyarısı veriyor. Komut bir aracının bölmesi dışında, örneğin düz bir uçbirimde çalıştırıldı. Collie göndereni bölmenin kendi ortamından adlandırır. Bölmesiz gönderme reddedilir. Komutu aracının bölmesinde çalıştırın veya telefondan gönderin. Bir aracı bölmesinde collie walky who, bölmenizi (you) ile işaretler. "no Collie bridge on this machine knows this pane" hatası, bölmenin başka bir Collie'ye ait olduğu anlamına gelir. "no running Collie bridge answers" hatası köprünün kapalı olduğu anlamına gelir: collie status çalıştırın.

Mesaj "held" durumunda ve henüz yazılmadı. collie walky status <id> "held: draft present" veya "held: turn running" çıktısı veriyor. Kutuda bir taslak bulunuyor veya ajan çalışıyor. Kutu temizlendiğinde veya tur bittiğinde Collie mesajı yazar (60 dakikaya kadar). Tekrar göndermeyin. Mesajın şimdi iletilmesini sağlamak için o paneldeki taslağı gönderin veya temizleyin. Daha eski bir lead altında "queued (outcome known on the lead)" ifadesi de beklemek gerektiği anlamına gelir.

Mesaj gelen kutusunda bekliyor ve yazılmadı. collie walky status <id> "waiting in the inbox, not typed" uyarısını ve nedenini yazdırır. "held past 60 minutes", 60 dakikalık bekletme süresi boyunca kutuda bir taslağın kaldığı, panelin meşgul kaldığı veya bir iletişim kutusunun açık kaldığı anlamına gelir: Collie asla bir taslağa veya iletişim kutusuna yazmaz. "box not free", Collie'nin boş bir giriş kutusunu okuyamadığı anlamına gelir. "pane busy", önceki bir mesajın 2 dakika sonra orada hâlâ yazılmakta olduğu anlamına gelir. "pane replaced", mesaj beklerken paneli başka bir oturumun devraldığı anlamına gelir. Diğer ikisi "no terminal" ve "bridge restarted" seçenekleridir. O panelde collie walky inbox komutunu çalıştırın veya telefondaki panel menüsünden Messages bölümünü açın. Collie mesajı tekrar yazmaz.

collie walky send "not sent: pane replaced" uyarısı veriyor. Adres #k3f9 gibi bir belirteçle bitiyor ve adlandırdığı panel kapandı. Artık o panel kimliğini başka bir panel tutuyor; bu yüzden Collie mesajı oraya yazmaz. collie walky who komutunu çalıştırın ve yeni adrese gönderin. "not sent: sender gone" cevabı veren bir yanıt da aynı nedene sahiptir: mesajı gönderen panel kapandı veya kimliğini artık başka bir panel tutuyor.

Bir paneldeki üstbilgi "no log record on this machine" gösteriyor. Telefon, ekran metninde bir walky talky üstbilgisi buldu ancak bu makinenin günlüğünde o kimliğe sahip bir mesaj yok. Satırı birisi veya bir şey yazdı ya da günlük 7 gün veya 2.000 satır sonra mesajı sildi ya da mesajı başka bir Collie tutuyor. collie walky status <id> komutunu çalıştırın: "no record of <id> on this machine" bunu doğrular. Bir crew üyesindeki bir panel için komutu o üyede çalıştırın: telefonun okuduğu günlük onun günlüğüdür. Satırı düz metin olarak ele alın ve gerekirse gönderene sorun.

Yetenek eski. collie doctor, skill-walky-talky satırında uyarı veriyor ve ajan eski yönergeleri izliyor. Bir talimat dosyasındaki metin bu derlemeden farklı. Hangi harness'ın geride kaldığını görmek için collie skill status komutunu çalıştırın. Bir betik içinde collie skill status --check komutunu çalıştırın: bir kopya eskiyse hiçbir şey yazdırmaz ve 3 koduyla çıkar. collie skill install all ile düzeltin, ardından ajanı yeniden başlatın. refused olarak işaretlenmiş bir hedef sembolik bir bağdır veya bozuk işaretçilere sahiptir; bir kurulum işlemi buna asla dokunmaz.

Dayanıklı aracılar

Bağladığınız bir durable agent kendi kontrollerine, gerekçelerine ve durumlarına sahiptir. collie durable list ve collie doctor ile başlayın, ardından Dayanıklı bir aracıda sorun giderme içeriğini okuyun.