imece nasıl çalışır

Parçalar

Her ekip üyesinin makinesinde bir masaüstü uygulaması, yerel bir arka plan servisi (daemon) ve yerel bir veritabanı çalışır. Ekip, imece'nin sunucuları üzerinden senkronlanır.

Sunuculara ulaşamazsan imece makinende çalışmaya devam eder. Yazdığın kayıtlar kuyruğa girer ve bağlantı gelince ekibe gider; o sürede ekibin yeni kayıtları sana gelmez. Bağlantı gelince kaçırdıkların alınmaya çalışılır; alınamayan olayların sayısını masaüstü gösterir.

• Masaüstü uygulaması: ekip kanalı, DM, Yapılacaklar, Kod ve Oturumlar ekranlarını gösterir, bildirim gönderir. Arayüzü yerel daemon sunar.
• Daemon: makinende arka planda çalışan yerel servis. Veritabanını açar, sunucularla konuşur ve Claude Code hook'larına cevap verir. Masaüstü penceresini kapatsan da çalışmaya devam eder.
• Veritabanı: makine başına yerel bir veritabanı. Kararlar, notlar, handoff'lar ve mesajlar burada saklanır. Prompt'unun metni makinende kalır.
• .imece/ klasörü: imece için seçtiğin projede okunabilir bir kopya tutulur. Klasör git'e girmez. imece CLAUDE.md dosyanı değiştirmez.
• Sunucular: giriş, ekip, üye ve kanal listeleri ile ekibin olaylarını makineler arasında iletme.

Bir karar agent'tan agent'a nasıl gider

Örnek: Ayşe'nin agent'ı bir karar verir, Mert'in agent'ı bunu çalışırken görür. Aşağıdaki yol Claude Code için kurulu; diğer agent'lar için Desteklenen agent'lar bölümüne bak.

• Kayıt. Ayşe'nin agent'ı kararı kaydeder. Ne zaman kayıt tutacağına agent karar verir; kaydetmeyebilir.
• Yerel yazım. Kayıt önce makinendeki veritabanına yazılır. Daemon o sırada çalışmıyorsa da kayıt düşer; daemon açılınca işler.
• Yayılma. Daemon kaydı ekibin öteki makinelerine ileten sunuculara gönderir. Kişisel kayıtlar ekibe gönderilmez.
• Teslim. Claude Code'da imece, ekibin ilgili kayıtlarını agent çalışırken context'ine ekler (hook'larla). Eklenecek bir şey yoksa bir şey eklenmez.
• Ekip arkadaşlarının yazdığı metin agent'a veri olarak işaretli ulaşır, talimat olarak değil.
• Sohbet mesajları ve DM'ler agent'ın context'ine eklenmez.

Agent neler kaydeder ve arar

imece'nin MCP sunucusu agent'a ekip için araçlar verir. Araçlar yalnız bir ekibe katılmış makinede çalışır. Ne zaman kullanacağına agent karar verir.

Agent'ın kaydedebildikleri:

• Aldığı kararlar.
• Bitirdiği işler.
• Çıkardığı dersler.
• Denenip bırakılan yollar.
• Yarım kalan işler.
• Başka bir role handoff.
• Agent ayrıca ekibin kayıtlarında arama yapabilir. Sohbet geçmişini yalnız sen izin verdiğinde okur: sohbet ekranındaki “Okumaya izin ver · 5 dk” düğmesine basarsın ve izin sınırlı bir süre geçerli olur. DM'ler aranamaz.

Desteklenen agent'lar

imece bir agent'a iki şey sunar: MCP araçları ve Claude Code'da hook'lar. Hook yalnız Claude Code için kurulur; bu yüzden kayıtların agent'ın context'ine kendiliğinden eklenmesi yalnız Claude Code için geçerli.

• Claude Code: masaüstündeki Yardım panelinden Claude Code'u bağladığında ya da ekibe katılırken Claude Code'u seçtiğinde imece, Claude Code'un ayarlarına kendi hook'larını ve MCP sunucusunu ekler. Başka araçların girdilerine dokunmaz. imece'yi kaldırdığında yalnız imece'nin girdileri silinir.
• Claude Code hook'ları kullanıcı düzeyinde kurulur: bu makinedeki her Claude Code session'ında çalışır ve imece için seçmediğin bir projede boş döner. Kurulumdan önce açılmış bir session, yeniden başlayınca yeni girdileri görür.
• Codex ve Cursor: masaüstünde Oturumlar bölümünde Yeni oturum ile başlatırsın; imece MCP sunucusunu session'a kendisi verir. Agent senin kendi girişinle çalışır. Cursor CLI ya da Codex (Codex için ayrıca codex-acp adaptörü) bu bilgisayarda kurulu ve girişli olmalı; imece bunları paketlemez, eksikse kurulum komutunu gösterir.
• Codex ve Cursor session'larında imece'nin hook'ları çalışmaz. Kayıtlar bu agent'ların prompt'larına kendiliğinden eklenmez; agent ekibin kayıtlarında arama yapınca onlara ulaşır.
• MCP destekli başka CLI'lar: Yardım panelindeki “Agent'ını bağla” bölümü hazır bir ayar verir. Ayar, mcpServers altında imece adlı bir girdidir: command imece'nin yolu, args ise yalnız mcp. Bunu agent'ının MCP ayarlarına eklersin. Bu agent'lar yalnız MCP araçlarını kullanır; kayıtlar prompt'a kendiliğinden eklenmez. imece projeyi, MCP sunucusunun başlatıldığı klasördeki git reposundan belirler.

Handoff

Handoff'u agent gönderir ya da sen masaüstünde “Handoff'a çevir” ile gönderirsin. Handoff kişiye değil role gider: rolü taşıyan herkes görür, işi ilk üstlenen alır. Sonuç gönderene döner.

Ekipte olmayan bir role gönderirsen hata döner ve geçerli roller listelenir. Rolü taşıyan etkin bir üye yoksa handoff kaydedilir ve ekip görür, ama kimseye atanmaz; gönderen bunu hemen öğrenir. Üstlenilmeyen handoff bir süre sonra bayatlar (stale) ama hâlâ üstlenilebilir.

• Masaüstünde: handoff gelince Yapılacaklar listesine düşer ve bildirim gelir. Üstlenmek ve kapatmak oradan yapılır.
• Claude Code'da: handoff makineye ulaştıktan sonra agent'ın context'ine eklenir. İşin açıklaması ve gerekçesi birlikte gelir.
• Codex, Cursor ve diğer MCP agent'larında: agent ekibin kayıtlarında arama yapınca, bekleyen handoff'ları görür.
• Gönderen sonucu: alıcı handoff'u kapatınca ya da reddedince durum ve varsa sonuç metni gönderene ulaşır.

AI aracı kullanmayan üyeler

Ekibe agent olmadan da katılabilirsin: katılırken “Agent kullanmıyorum” seçilir. Masaüstü uygulamasından şunları yaparsın.

• Ekip kanalına ve proje kanallarına yaz, birinden ya da bir rolden bahset (@), yeni kanal aç.
• DM: bir ekip arkadaşına doğrudan yaz. DM yalnız iki katılımcıya iletilir.
• Bir mesajı “Handoff'a çevir” ile bir role gönder. Rolü taşıyan üye handoff'u Yapılacaklar'da görür; agent kullanan üyenin agent'ı da kendi context'inde görür.
• Yapılacaklar'da sana gelen handoff'u üstlen ve kapat.
• Ekip panelinde, Claude Code kullanan üyelerin hangi projede ve hangi branch'te çalıştığını gör.

Çakışma uyarısı

Masaüstü uygulamasının Kod bölümü, değiştirdiğin dosyaları ekip arkadaşlarının branch'leriyle karşılaştırır. Karşılaştırma makinende, git ile yapılır. Kod bölümü, reposu bu makinede eşlenmiş projelerde çalışır.

Uyarı bilgi verir; branch'i, commit'i ya da merge'i engellemez.

Ekip arkadaşının ne üzerinde çalıştığı (proje, branch adı ve konu) ekibe duyurulur. Bu duyuru yalnız Claude Code'da çalışan üyeler için var; duyurusu olmayan üye için uyarı çıkmaz.

• Dosya düzeyi: senin branch'inin base branch'ten (örneğin main) beri değiştirdiği dosyalar ile commit'lemediğin dosyalar, ekip arkadaşının push'ladığı branch'in değiştirdiği dosyalarla kesişirse ortak dosyalar listelenir.
• Dosya düzeyi karşılaştırma için ekip arkadaşının branch'i uzak repoda olmalı ve senin makinende görünmeli. Kod bölümündeki Yenile düğmesi git fetch --prune origin çalıştırır.
• Uyarı Kod bölümünde ve Ekip panelinde, ilgili kişinin kartında görünür. Agent turu bitince, Yenile'ye bastığında ya da ekip durumu değiştiğinde güncellenir.
• Kod bölümü ayrıca yarım kalmış rebase ya da merge, base branch'in gerisinde kalma ve başka bir branch'te aynı numaralı migration gibi durumları da kontrol eder.

Bir şey ulaşmıyorsa

Bir kayıt ya da handoff agent'ın context'ine gelmiyorsa şunlara bak. Bir araç çağrısı başarısız olunca hata mesajı agent'a ne yapacağını da söyler.

imece bir kilit değil, bir koordinasyon sinyalidir. Bir şeyin agent'ın context'inde olması, agent'ın ona göre davranacağı anlamına gelmez. Konusu ilgisiz bir prompt'ta agent bekleyen bir handoff'tan söz etmeyebilir; handoff Yapılacaklar'da durmaya devam eder. Kayıtlar zamanla eskiyebilir ve imece bunların yalnız bir kısmını işaretler.

• Claude Code session'ı kurulumdan önce açıldıysa: Claude Code'u yeniden başlat. Hook'lar ve MCP girdisi yeni session'larda etkin olur.
• Proje bu makinede seçilmemişse: hook boş döner ve kayıt yazan araçlar PROJECT_NOT_SELECTED hatası verir. Masaüstünde Proje bağla ile projeyi seç, sonra Claude Code'u yeniden başlat; MCP sunucusu projenin seçili olup olmadığına session başında bakar.
• Bu makine bir ekibe katılmamışsa: araçlar NOT_JOINED hatası verir.
• Yerel veritabanı açılamıyorsa: araçlar NO_DATABASE hatası verir. Hook ve MCP sunucusu ayakta kalır, agent'ın işi sürer.
• imece servisi (daemon) çalışmıyorsa ya da yavaşsa: hook boş döner ve agent beklemeden devam eder. Masaüstü uygulaması servisi başlatır.
• Sunuculara ulaşılamıyorsa: yazdığın kayıtlar kuyruğa girer ve bağlantı gelince ekibe gider. O sürede ekibin yeni kayıtları sana gelmez.

Güvenlik ve veri

Hangi verinin nerede durduğunu Güvenlik ve veri sayfasında anlatıyoruz.

Güvenlik ve veri