wormclaude

WormClaude CLI

Qwen 2.5 tabanlı, OpenAI-uyumlu backend'e bağlanan uçbirim (ink TUI) AI kodlama/güvenlik asistanı. Claude Code'un araç/komut/agent mimarisinin yerel, bulut-bağımsız uyarlamasıdır.

---

Dosya dosya: ne eklendi

Yeni dosyalar (src/) — bu oturumda sıfırdan eklendi

Dosya	Ne yapar
agent.ts	Yeniden kullanılabilir tool-calling döngüsü (runAgentLoop) — alt-agent çekirdeği. completeText() tek-seferlik yanıt yardımcısı.
commands.ts	18 slash komutu (/help /clear /compact /context /cost /config /model /diff /commit /review /init /memory /doctor /mcp /tasks /kill /dream /export /resume /quit).
tasks.ts	Arka plan görev kayıt defteri (registry) — shell/agent/dream görevleri, durum/çıktı izleme, EventEmitter.
mcp.ts	MCP istemcisi (resmi @modelcontextprotocol/sdk). .wormclaude/mcp.json'dan sunucu okur, araçları OpenAI şemasına çevirir.
usage.ts	Billing/token ölçümü — model-bazlı maliyet, oturum+kümülatif sayaç, bütçe limiti, .wormclaude/usage.json.
compact.ts	Oto-compact: bağlam eşiği + 9-bölümlü özet promptu + isContextError (reactive compact tetiği).
memory.ts	Oto-hafıza: SessionMemory tetiği + autoDream gate + PID kilidi. .wormclaude/memory.md.
toolSummary.ts	Araç-grubu özeti — 2+ araç sonrası tek satır git-commit tarzı etiket.
tips.ts	Spinner/footer ipuçları (14 ipucu, cooldown'lı, .wormclaude/tips.json).

Değiştirilen dosyalar (mevcuttu, genişletildi)

Dosya	Eklenen
tools.ts	Claude Code araç açıklamaları (birebir); Agent + TaskOutput araçları; Bash run_in_background; MCP yönlendirme; paralel araç çalıştırma (executeToolCalls); per-tool metadata (TOOL_META: readOnly/concurrencySafe/needsPermission/validate).
api.ts	usage yakalama (stream_options.include_usage); retry/backoff (fetchWithRetry, jitter); abort/interrupt (AbortSignal).
cli.tsx	Komut sistemi bağlama; footer task pill; MCP otomatik bağlanma; oto-compact + oto-hafıza tetikleri; usage kaydı; izin dialogu; bütçe/maxTurns/Esc-kes; reactive compact; tip + araç özeti gösterimi.
theme.ts	(değişmedi)

Backend (C:\Users\potur\Desktop\modelegitim\api\server.py)

Eklenen	Açıklama
POST /v1/chat/completions	OpenAI-uyumlu gateway: streaming + tools geçişi + usage. Ollama'yı sarar.
GET /v1/models	Model listesi.
Model takma adı	wormclaude → qwen2.5:7b (env WORMCLAUDE_DEFAULT_MODEL).
Opsiyonel auth	WORMCLAUDE_API_KEYS env'i set edilirse Bearer key zorunlu.
Billing log	api/billing.jsonl — istek başına {ts, key, model, prompt_tokens, completion_tokens}.

Not: Eski route'lar (/chat, /chat/stream) korundu; sadece /v1/* eklendi.

---

Özellikler (tümü çalışır, test edildi)

• Araçlar: Bash, Read, Write, Edit, Glob, Grep, WebFetch (Claude Code birebir açıklamalar) + Agent, TaskOutput
• Çoklu-agent: alt-agent (Agent), arka plan görevleri (run_in_background), koordinatör, dream
• MCP: stdio/SSE/HTTP sunucu desteği
• Paralel araç çalıştırma: salt-okunur araçlar eşzamanlı (limit 10), yazanlar sıralı
• İzin sistemi: Bash/Write/Edit öncesi onay (Evet / Evet-hep / Hayır)
• Billing: token/maliyet ölçümü + oturum bütçe limiti
• Retry/backoff: 408/409/429/5xx/529 + bağlantı hataları
• Oto-compact + reactive compact: bağlam dolunca / taşınca otomatik özetle
• Oto-hafıza: arka planda kalıcı bilgi çıkarımı
• Araç özeti + ipuçları: UX cilası
• Interrupt: çalışırken Esc ile kes

---

Dosya dosya: ne EKLENMEDİ (ve neden)

Claude Code kaynağından (Desktop\tools, Desktop\wormclaudegenel) bilerek atlananlar — hepsi Anthropic bulutuna/hesabına/SDK'sına bağlı, yerelde karşılığı yok:

services/ — atlananlar

Klasör/dosya	Neden eklenmedi
analytics/ (datadog, growthbook, sink...)	Anthropic telemetrisi
api/ (claude.ts, bootstrap, usage, overage, referral)	Anthropic bulut API + faturalandırma (mantığı: retry+billing uyarlandı)
oauth/	Anthropic hesabı/OAuth
mcp/ (auth, claudeai, xaa, officialRegistry...)	Bulut-bağımlı MCP (çekirdek MCP istemcisi yeniden yazıldı)
plugins/	Eklenti/marketplace sistemi
policyLimits/, remoteManagedSettings/, settingsSync/, teamMemorySync/	Kurumsal/uzak senkronizasyon
voice* (4 dosya)	Harici STT servisi
rateLimit*, mockRateLimits, claudeAiLimits*	Anthropic abonelik limitleri
notifier, diagnosticTracking, internalLogging, vcr, preventSleep	İç altyapı/OS
lsp/ (7 dosya)	Kod dil-sunucusu — opsiyonel, kurulmadı
MagicDocs/, AgentSummary/, PromptSuggestion/ (+speculation), awaySummary	İncelendi, orta/düşük değer → opsiyonel bırakıldı

cli/ (giriş/transport katmanı) — tamamı atlandı

transports/ (WebSocket/SSE/remote), handlers/ (auth/mcp/plugins/agents), print.ts, structuredIO.ts, remoteIO.ts, update.ts → Anthropic uzak agent/SDK protokolü, yerelde gereksiz.

tasks/ — kısmen

Eklenen	Atlanan
LocalShellTask (arka plan Bash), LocalAgentTask (alt-agent), DreamTask (hafıza) → tasks.ts'e uyarlandı	RemoteAgentTask (uzak bulut), InProcessTeammateTask (AsyncLocalStorage takım izolasyonu), coordinator/ (analytics-bağımlı)

Çekirdek motor (query.ts, QueryEngine.ts, Tool.ts, tools.ts) — incelendi

Uyarlandı	Atlandı (opsiyonel)
Agent döngüsü, paralel araç, per-tool arayüz, izin, bütçe/maxTurns/interrupt, reactive compact	Streaming tool executor, stop hooks, max-output-token escalation (8K→64K)

---

Ortam değişkenleri

WORMCLAUDE_BASE_URL=http://127.0.0.1:8788/v1   # backend
WORMCLAUDE_API_KEY=wormclaude                  # backend key
WORMCLAUDE_MODEL=wormclaude                    # model (backend qwen2.5:7b'ye çözer)
WORMCLAUDE_MAX_TURNS=25                         # tur limiti
WORMCLAUDE_BUDGET_USD=0                         # oturum maliyet tavanı (0=sınırsız)
WORMCLAUDE_CONTEXT_WINDOW=32768                 # oto-compact için pencere
WORMCLAUDE_MAX_RETRIES=5                        # bağlantı retry
WORMCLAUDE_MAX_TOOL_CONCURRENCY=10             # paralel araç limiti
# Backend tarafı:
WORMCLAUDE_DEFAULT_MODEL=qwen2.5:7b            # takma ad hedefi
WORMCLAUDE_API_KEYS=key1,key2                   # auth (boşsa kapalı)
OLLAMA_NUM_CTX=8192                             # Ollama bağlam

---

Kurulum & çalıştırma

# Backend (ayrı pencere)
powershell -File C:\Users\potur\Desktop\modelegitim\api\BASLAT_API.ps1

# CLI
cd C:\Users\potur\Desktop\wormclaude-cli-ts
npm install
npm run build
wormclaude        # veya: npm run dev

MCP sunucu eklemek

.wormclaude/mcp.json:

{
  "mcpServers": {
    "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\proje\\yol"] }
  }
}

Sonra CLI'da /mcp ile gör, /mcp reconnect ile yeniden bağla.

---

Ticari (aylık abonelik) için hazır kancalar

1. Auth aç: WORMCLAUDE_API_KEYS="musteri1,musteri2" — her müşteriye anahtar
2. Fiyat koy: usage.setPricing("qwen2.5:7b", { in: 0.5, out: 1.5 }) — /cost USD gösterir
3. Bütçe tavanı: WORMCLAUDE_BUDGET_USD=5 — oturum maliyeti aşınca durur
4. Faturalandır: api/billing.jsonl'i aylık topla (server-tarafı = güvenilir kaynak)