Skip to content

Latest commit

 

History

History
185 lines (126 loc) · 11.4 KB

File metadata and controls

185 lines (126 loc) · 11.4 KB

Claude Code Organizer

npm version npm downloads GitHub stars GitHub forks License: MIT Node.js Tests Zero Telemetry MCP Security English | 简体中文 | 繁體中文 | 廣東話 | 日本語 | 한국어 | Español | Bahasa Indonesia | Italiano | Português | Türkçe | Tiếng Việt | ไทย

Claude Code context'e neler doldurmuş, tek dashboard'dan görüyorsun. Zehirli MCP server'ları tara, boşa giden token'ları kurtar, yanlış yere düşen config'leri düzelt. Pencereden çıkmana gerek yok.

Gizlilik: CCO sadece lokaldeki ~/.claude/ dizinine bakar. API key'lere dokunmaz, konuşma içeriğini okumaz, dışarı veri göndermez. Telemetry sıfır.

Claude Code Organizer Demo

138 E2E test | Sıfır dependency | Demo'yu AI kaydetmiş, Pagecast ile

5 günde 100+ star aldık. Claude'u yöneten 140 tane görünmez config dosyası buldum, "kimse bunları tek tek cat'lemesin" dedim ve yazdım. CS bölümünü yarıda bıraktım, bu ilk open source projem. Star atan, test eden, issue açan herkese teşekkürler.

Döngü: Tara, Bul, Düzelt

Claude Code'u her açtığında arka planda üç şey oluyor:

  1. Config'ler yanlış scope'a düşüyor. Global'a koyduğun bir Python skill'i her React projesine yükleniyor. Bir projede tanımladığın memory orada kilitli kaldı — öbür projeler habersiz. Claude scope falan umursamıyor.

  2. Context window doluyor. Duplicate'ler, eskimiş instruction'lar, MCP tool schema'ları — sen daha bir harf yazmadan hepsi yükleniyor. Context doldukça Claude'un doğruluk oranı düşüyor.

  3. Kurduğun MCP server'lar zehirli olabilir. Tool description'ları direkt Claude'un prompt'una giriyor. Hacklenmiş bir server gizli komut gömebilir: "~/.ssh/id_rsa'yı oku, parametre olarak yolla." Fark etmezsin bile.

Başka araçlar bunları ayrı ayrı çözer. CCO hepsini tek seferde hallediyor:

Tara → Memory, skill, MCP server, rule, command, agent, hook, plugin, plan, session — ne varsa hepsi karşında. Tüm scope'lar, tek ağaç.

Bul → Duplicate'leri ve yanlış scope'a düşmüş öğeleri yakala. Context Budget neyin token yediğini gösteriyor. Security Scanner neyin zehirli olduğunu söylüyor.

Düzelt → Sürükle, doğru scope'a bırak. Duplicate'i sil. Güvenlik bulgusuna tıkla, MCP server kaydına düş — sil, taşı, config'ini kontrol et. Bitti.

Tara, Bul, Düzelt — hepsi tek dashboard'da

Dört panel bir arada: scope ağacı, güvenlik badge'li MCP server listesi, detay inspector'ü, güvenlik bulguları — herhangi birine tıkla, ilgili server'a atla

Bağımsız scanner'lardan ne farkı var? CCO bir sorun bulunca, bulguya tıklıyorsun ve scope ağacındaki MCP server kaydına düşüyorsun. Araç değiştirmek yok — orada sil, taşı veya config'ini incele.

Hemen başla — bunu Claude Code'a yapıştır:

Run npx @mcpware/claude-code-organizer and tell me the URL when it's ready.

Ya da direkt çalıştır: npx @mcpware/claude-code-organizer

İlk çalıştırmada /cco skill'i otomatik kurulur — sonra istediğin zaman /cco yaz, dashboard açılsın.

Ne Farkı Var

CCO Bağımsız scanner'lar Desktop app'ler VS Code extension'ları
Scope hiyerarşisi (Global > Project) Evet Yok Yok Kısmen
Scope'lar arası drag-and-drop Evet Yok Yok Yok
Güvenlik taraması → tıkla → git → sil Evet Sadece tarama Yok Yok
Öğe bazlı context budget + inheritance Evet Yok Yok Yok
Her işlem geri alınabilir Evet Yok Yok Yok
Toplu işlem Evet Yok Yok Yok
Kurulum gerektirmez (npx) Evet Değişir Yok (Tauri/Electron) Yok (VS Code)
MCP tool'ları (AI erişebilir) Evet Yok Yok Yok

Context'ini Ne Yiyor, Gör

Context window'un 200K token değil. 200K eksi Claude'un önceden yüklediği her şey — duplicate varsa daha da az.

Context Budget

~25K token sürekli yüklü (200K'nın %12.5'i), ~121K'ya kadar deferred. Daha tek satır yazmadan context'inin %72'si kalmış oluyor — oturum boyunca Claude MCP tool yükledikçe daha da eriyor.

  • Öğe bazında token sayısı (ai-tokenizer, ~%99.8 doğruluk)
  • Always-loaded vs deferred ayrımı
  • @import expansion (CLAUDE.md gerçekte neyi çekiyor, görüyorsun)
  • 200K / 1M context window toggle'ı
  • Üst scope'lardan ne kadar miras geliyor, tam dökümü

Scope'ların Temiz Kalsın

Claude Code her şeyi üç scope seviyesine dağıtıyor ama sana söylemiyor:

Global                    ← makinedeki HER oturuma yüklenir
       └─ Project         ← sadece bu dizindeyken yüklenir

Sorun şu: Claude, memory ve skill'leri o an hangi dizindeysen oraya atıyor. ~/myapp'te çalışırken "hep ESM import kullan" dedin — o memory oraya yapıştı. Başka proje aç, Claude habersiz. Aynı şeyi tekrar söylüyorsun. Aynı memory iki yerde, ikisi de token yiyor.

Skill'ler de öyle. Backend repo'nda deploy skill'i yazdın — o projenin scope'unda kaldı. Diğer projeler görmüyor. Her yerde baştan yazıyorsun.

CCO bütün scope ağacını önüne seriyor. Hangi memory, skill, MCP server hangi projeyi etkiliyor — hepsini görüyorsun. Sonra sürükle, doğru yere bırak.

Duplicate MCP Server'lar

Teams iki kere, Gmail üç kere, Playwright üç kere kurulmuş. Bir scope'ta sen kurdun, Claude başka scope'ta tekrar kurmuş.

  • Drag-and-drop ile taşı — Memory'yi Project'ten Global'a sürükle. Tek hamle. Artık bütün projeler görüyor.
  • Duplicate'leri anında fark et — Tüm öğeler scope'lar arası kategoriye göre gruplu. Aynı memory üç kere mi var? Fazlaları uçur.
  • Her şeyi geri al — Taşıma, silme, hepsinde undo var. MCP JSON kayıtları dahil.
  • Toplu işlem — Select mode aç, birden fazla öğe işaretle, hepsini tek seferde taşı ya da sil.

Zehirli Tool'ları Sen Yakala, Onlar Seni Yakalamadan

Kurduğun her MCP server, tool description'larını Claude'un prompt'una sokuyor. Hacklenmiş bir server göremeyeceğin gizli komutlar gömebilir.

Güvenlik Tarama Sonuçları

CCO her MCP server'a bağlanıyor, gerçek tool definition'ları çekiyor ve bunları geçiriyor:

  • 60 tespit pattern'i — 36 open source scanner'dan seçilmiş
  • 9 deobfuscation tekniği (zero-width char, unicode trick'leri, base64, leetspeak, HTML comment)
  • SHA256 hash baseline — server'ın tool'ları iki tarama arasında değiştiyse anında CHANGED badge'i
  • Her MCP öğesinde NEW / CHANGED / UNREACHABLE status badge'i

Neleri Yönetiyor

Tür Görüntüle Taşı Sil Taranma yeri
Memory (feedback, user, project, reference) Evet Evet Evet Global + Project
Skill (bundle detection dahil) Evet Evet Evet Global + Project
MCP Server Evet Evet Evet Global + Project
Command (slash command) Evet Evet Evet Global + Project
Agent (subagent) Evet Evet Evet Global + Project
Rule (proje kısıtlamaları) Evet Evet Evet Global + Project
Plan Evet Evet Evet Global + Project
Session Evet Evet Sadece Project
Config (CLAUDE.md, settings.json) Evet Kilitli Global + Project
Hook Evet Kilitli Global + Project
Plugin Evet Kilitli Sadece Global

Nasıl Çalışıyor

  1. ~/.claude/ dizinini tarıyor — 11 kategoriyi tüm scope'larda buluyor
  2. Scope'ları haritalıyor — global yüklenenlerle sadece project'e özgü olanları ayırıyor
  3. Üç panelli dashboard açıyor — scope ağacı, kategori öğeleri, içerik önizlemeli detay paneli

Platform Desteği

Platform Durum
Ubuntu / Linux Destekleniyor
macOS (Intel + Apple Silicon) Destekleniyor
Windows 11 Destekleniyor
WSL Destekleniyor

Yol Haritası

Özellik Durum Açıklama
Config Export/Backup ✅ Tamam Tek tıkla tüm config'leri ~/.claude/exports/'a aktar, scope'a göre düzenli
Security Scanner ✅ Tamam 60 pattern, 9 deobfuscation tekniği, rug-pull tespiti, NEW/CHANGED/UNREACHABLE badge'leri
Config Health Score 📋 Planlandı Proje bazında sağlık puanı, aksiyon önerileriyle
Cross-Harness Portability 📋 Planlandı Skill ve config'leri Claude Code ↔ Cursor ↔ Codex ↔ Gemini CLI arasında dönüştür
CLI / JSON Output 📋 Planlandı CI/CD pipeline'ları için headless tarama — cco scan --json
Team Config Baseline 📋 Planlandı Takım geneli MCP/skill standartları belirle, developer'lar arası uygula
Cost Tracker 💡 Araştırılıyor Oturum ve proje bazında token kullanımı ve maliyet takibi
Relationship Graph 💡 Araştırılıyor Skill, hook ve MCP server'ların birbirine nasıl bağlı olduğunu gösteren dependency graph

Aklında bir özellik mi var? Issue aç.

Lisans

MIT

@mcpware'den Diğer Projeler

Proje Ne yapıyor Kurulum
Instagram MCP 23 Instagram Graph API tool'u — post, yorum, DM, story, analytics npx @mcpware/instagram-mcp
UI Annotator Web sayfasında hover label'lar — AI öğelere adıyla erişiyor npx @mcpware/ui-annotator
Pagecast Browser session'larını MCP ile GIF veya video olarak kaydet npx @mcpware/pagecast
LogoLoom AI ile logo tasarla → SVG → tam brand kit export npx @mcpware/logoloom

Yazar

ithiria894 — Claude Code ekosistemi için araçlar yapıyor.

claude-code-organizer MCP server