quotalala 0.0.0-stage → 1.1.0

package/AGENTS.md

@@ -0,0 +1,123 @@
+# Quotalala — Proje Bilgisi (her oturumda oku)
+
+## Proje nedir
+Quotalala, kullanıcının Claude, ChatGPT (Codex) ve Gemini aboneliklerinin
+kotalarını boşa harcamadan, tek bir prompt'u bu üç ajana otomatik
+dağıtan yerel bir masaüstü (Electron) uygulamasıdır. Claude baş koordinatördür.
+
+## Dağıtım hedefi (baştan buna göre tasarla)
+- MIT lisanslı açık kaynak proje, GitHub Releases üzerinden dağıtılacak.
+- Windows kurulum dosyası (NSIS .exe) üretilir (`electron-builder`).
+- macOS ve Linux desteği ileride eklenecek şekilde tasarlanır.
+- Kurulumda ve çalışma anında derleme gerektiren paket olmasın (node-pty vb. yok).
+
+## Kesin kurallar
+- API anahtarı kullanılmaz. Sadece kullanıcının kendi giriş yaptığı
+  resmi CLI'lar çalıştırılır: `claude -p`, `codex exec`, `agy`.
+- Giriş bilgisi dosyalarının (creds, token, auth.json) İÇERİĞİ asla
+  okunmaz, kopyalanmaz. Giriş durumu CLI'ın kendi status komutuyla
+  veya CLI hata çıktısıyla kontrol edilir.
+- Proxy, hesap paylaşımı, aboneliği API'ye çevirme yok.
+- Prompt'lar CLI'lara stdin üzerinden gönderilir.
+- Gemini ajanı Antigravity CLI (`agy`) çalıştırır ve varsayılan olarak kapalıdır; Google'ın otomatik CLI kullanımına karşı bazı hesapları kısıtladığı rapor edildiğinden bu ajan kullanıcının manuel onay ve risk kabulüyle açılır.
+
+## Mimari
+- Electron tabanlı masaüstü uygulaması (Express sunucu kullanılmaz).
+- Backend mantığı Electron Main Process'te çalışır (`src/main/`).
+  - `main.js`: Pencere yönetimi, sistem tepsisi (tray) ikonu, yerel Windows bildirimleri.
+  - `preload.js`: Güvenli IPC köprüsü (`contextBridge`, `contextIsolation: true`, `nodeIntegration: false`).
+  - `cli-locator.js`: CLI yollarını bulma (.cmd / .bat / .exe ayrımı).
+  - `quota.js`: Kullanıcının ev dizininde `.quotalala/quota-state.json` üzerinde kota/iş takibi.
+  - `coordinator.js`: Claude tabanlı görev bölme ve sentezleme.
+  - `agents/`: Her ajan ayrı modül (eklenti mimarisi: claude, codex, gemini).
+- Frontend Renderer (`src/renderer/`):
+  - Tek ekran, sade HTML/CSS/JS.
+  - Çoklu dil desteği (i18n: tr.json, en.json, varsayılan Türkçe).
+  - Main process ile asenkron IPC olayları üzerinden canlı durum ve terminal akışı.
+
+## Koordinasyon akışı
+1. Prompt önce Claude'a gider, Claude sadece JSON plan döndürür:
+   alt görevler, her biri için ajan (claude/codex/gemini) ve gerekçe.
+2. Backend (main process) görevleri dağıtır. Ajanlar tamamlandı / soru / başarısız / engellendi sonucu bildirir.
+3. Claude ara sonuçları topluca değerlendirir; soruları yanıtlar, başka ajana danışma veya somut düzeltme görevi açar. Mesajlar yalnızca ilgili sonuç parçalarıyla aktarılır.
+4. Claude yeterli sonuçta doğrudan nihai sentezi verir; ek sentez çağrısı yapılmaz. En fazla 3 yönetim turu, toplam 8 görev, görev başına 2 deneme (soru/yanıt dahil), çalışma başına 20 çağrı sınırı vardır.
+5. Yeni koordinasyon oturumları managed-v1 akışını kullanır; eski kayıtlı planlar kendi akışlarıyla devam eder. Ekonomik mod tek ajanla doğrudan çalışır.
+
+## Kota mantığı
+- Her ajan için kullanım sayısı, son kullanım, son kota hatası ve
+  (varsa) yenilenme zamanı tutulur.
+- Kota hatası veren ajan "dolu" işaretlenir, iş diğerine aktarılır.
+- Koordinatöre kota durumu her seferinde gönderilir. Öncelik: az
+  kullanılan ve yenilenmesi yakın ajan. Claude kendi kotasını
+  koordinasyon ve zor işler için saklar.
+- Sistem tepsisi ikonu üzerine gelindiğinde ajanların anlık durumu görüntülenir.
+- Windows bildirimleri ile kota yenilenmesi yaklaşan ve kullanılmamış kotası olan ajanlar hatırlatılır.
+
+## Model seçimi (Quotalala'nın özelliği)
+- Koordinatör her alt görev için hem ajanı hem modeli seçer.
+  Kural: işin zorluğu ve token maliyeti. Kolay işe hafif/ucuz model,
+  zor işe güçlü model. En güçlü model varsayılan olarak KULLANILMAZ.
+- Model isimleri koda gömülmez. Kullanıcının home klasöründe
+  `.quotalala/models.json` dosyasında durur. Her model için:
+  ajan, model adı, seviye (hafif / orta / güçlü), göreli maliyet, kaynak (source).
+- Model adı uydurmak kesinlikle yasak. Kaynağı gösterilemeyen model
+  listeye giremez. Model listesindeki her giriş CLI çıktısı veya yerel
+  ayar/kod dosyalarından doğrulanmalıdır.
+- Seviye belirlerken model nesli esas alınır; isimdeki pro/flash/mini
+  gibi ekler tek başına ölçüt değildir. Mümkünse alias kullanılır.
+- Bir ajanda tek güçlü model varsa seviye farkı akıl yürütme/düşünme seviyesiyle sağlanır.
+- Preview modelleri listeye "preview": true alanıyla eklenir;
+  koordinatör bunları varsayılan seçim olarak kullanmaz.
+- Uygulama ilk açılışta her CLI'ın desteklediği modelleri kendi
+  komutlarıyla tespit etmeye çalışır; bulamazsa varsayılan listeyi
+  kullanır.
+- Ayarlar ekranında kullanıcı model listesini görüp düzenleyebilir.
+- Seçilen model abonelikte yoksa hata verip durmaz: bir alt seviyeye
+  veya o ajanın varsayılan modeline düşer ve akışta bunu bildirir.
+- Akış kaydında her görev için "ajan + model + neden" görünür.
+
+## Arayüz
+- Aktif proje odaklı tek ekran: solda proje seçimi ve o klasörün
+  konuşmaları, ortada kompakt ajan kartları ve görev kutusu, sağda
+  proje hafızası. Çıktılar, etkinlik zaman çizelgesi ve günlük ayrı sekmeler.
+- Klasör bir kez açılır ve son proje hatırlanır. Uygulama `--project`
+  klasör argümanıyla veya proje klasöründen başlatılabilir; her görevde
+  çalışma yolu yazılmaz. Geçmiş burada Quotalala'nın kendi oturumlarıdır.
+- Arayüz metinleri Türkçe ve İngilizce (i18n), varsayılan Türkçe.
+- Kod, değişken adları ve README İngilizce (açık kaynak standardı).
+
+## Çalışma kuralları (geliştirme yapan ajan için)
+- Bu kurallar Quotalala'yı geliştirirken senin davranışınla ilgilidir,
+  uygulamanın kendi model seçimini kısıtlamaz.
+- Testlerde kotayı koru: her CLI'a tek ve çok kısa prompt yeter
+  ("OK yaz"). Testlerde mevcut en hafif modeli kullan; çalışmazsa
+  varsayılana dön, model denemeleriyle vakit kaybetme.
+- Dosya silmeden veya proje dışına bir şey yazmadan önce kullanıcıya sor.
+- Her büyük adımdan sonra ne yaptığını kısaca özetle.
+- Kullanıcı onay vermeden git commit atma.
+
+## Yol haritası
+1. Sağlık testi ekranı ve CLI entegrasyonu (Tamamlandı)
+2. Electron masaüstü mimarisi, IPC köprüsü, Sistem Tepsisi ve Bildirimler (Tamamlandı)
+3. Arayüz i18n (TR/EN) ve tekil ajan prompt testi (Tamamlandı)
+4. Claude koordinatör ile çoklu ajan görev dağıtımı (Tamamlandı)
+5. Kota takibi, oran sınırları ve otomatik görev devri (Tamamlandı)
+6. Model seçimi: models.json, zorluk/maliyet bazlı seçim, geri düşme (Seviye seçimi, ayarlar ve CLI varsayılanına geri düşme tamamlandı; otomatik model keşfi bekliyor)
+7. electron-builder ile NSIS Windows Installer (.exe) ve GitHub Releases hazırlığı (Yerel NSIS üretimi, paket doğrulama ve GitHub kontrol akışı hazır; GitHub üzerinde çalıştırma, temiz kurulum testi, imzalama kararı ve yayın bekliyor)
+8. Gemini düşünme seviyesi kontrolü (CLI desteği netleşince)
+9. Geçmiş & proje hafızası: yerel oturumlar, devam etme, 2000 karakter özet, gizlilik ayarları (Tamamlandı)
+10. Günlük iyileştirmeleri: seçme/kopyalama, filtreler, yapılandırılmış hata kartları ve ortak sağlık durumu (Tamamlandı)
+11. Etkinlik zaman çizelgesi: yapılandırılmış koordinasyon olayları, tıklanabilir girdi/çıktı, son 20 başlıkla proje bağlamı ve oturuma devam etme (Tamamlandı)
+12. Görev sonucu doğrulama: CLI çıkış kodundan ayrı engellenme/başarısızlık, incelemede dosya-satır kanıtı ve ortak erişim engelinde gereksiz tekrarları durdurma (Tamamlandı)
+13. Aktif proje, klasöre göre otomatik konuşma/hafıza yükleme, son projeyi hatırlama ve modern masaüstü arayüzü (Tamamlandı)
+14. npm başlatıcısı: proje klasöründe `quotalala` / `npx quotalala`, Electron ile bağımsız paket ve paket içerik doğrulaması (Tamamlandı; npm `quotalala@1.0.0` yayımlandı)
+15. Çok dilli README: Q logosu, hızlı kurulum, dil bağlantıları ve EN/TR/DE/ES/FR kullanım belgeleri (Tamamlandı; 1.1.0 güncelleme notları ve örnek Electron ekran görüntüleri eklendi)
+16. Ekonomik mod ve kota sınırları: tek ajan/seviye, en fazla 8 alt görev, görev başına 2 deneme ve çalışma başına 20 çağrı; başarısız/aynı çıktıda hafıza çağrısını atlama (Tamamlandı; 256 sonuç özetiyle tekrar tespiti, hafıza 2000 karakter)
+17. Canlı stdout/stderr, süreç ağacını durdurma, ayarlanabilir zaman aşımı, kısmi çıktı ve eksik adımdan devam (Tamamlandı; Windows yerel süreç ve mock ajan testleri; macOS/Linux testi bekliyor)
+18. İsteğe bağlı düzenlenebilir plan onayı, backend doğrulaması ve Claude olmadan doğrudan ajan seçimi (Tamamlandı)
+19. Ajan beyanı/doğrulanan sonuç ayrımı, yerel dosya metaverisi, CLI komut/çıkış kodu kanıtları ve isteğe bağlı ek doğrulama (Tamamlandı; yapılandırılmış komut kanıtı şu an Codex; sentez bağımsız test sayılmaz)
+20. Tek Electron örneği, etkin görevde proje isteğini bekletme, benzersiz atomik kayıt, kesilen oturumları kurtarma ve özet tabanlı geçmiş (Tamamlandı; eski kayıtların ilk dönüşümü bir kez tam okuma yapar)
+21. Claude yönetim döngüsü: ajan soruları, Claude yanıtları, kontrollü ajanlar arası danışma, somut düzeltme görevleri, görünür ekip konuşması, sonraki tur plan onayı ve devam durumunun kaydı (Tamamlandı; en fazla 3 yönetim turu, kotasız mock ve üretim Electron arayüz testleri; gerçek abonelik çağrısı yapılmadı)
+22. Küçük ekip odası: gerçek görev olaylarından çalışan masalar, soru/yanıt balonları, tıklanabilir ve kopyalanabilir mesajlar, geçmiş/iptal durumları ve azaltılmış hareket desteği; arka planda bitiş/engel/plan onayı bildirimleri ve doğru oturuma geçiş (Tamamlandı; ek CLI çağrısı yok, Gemini risk onayı korunur; masaüstü bildirim sunumu işletim sistemi ayarlarına bağlı)
+
+23. 1.1.0 sürüm belgeleri ve ekran görüntüleri: EN/TR/DE/ES/FR README güncelleme notları, örnek verilerle gerçek Electron görselleri ve npm paketinde belge varlıklarının doğrulanması (Tamamlandı; üç görsel npm paketinde doğrulandı, 1.1.0 yayın kontrolü sürüm listesinde)

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## 1.1.0 — 2026-10-15
+
+### Claude-led teamwork
+
+Claude now answers worker questions, requests focused consultations and assigns concrete revisions after the initial plan. Its final management response includes the synthesis. The animated team room shows actual task events, copyable messages and disabled-agent states without extra CLI calls. Optional background notifications open the relevant session.
+
+### Execution and quota controls
+
+Economic mode sends a task directly to one agent and tier. Coordinated runs are bounded to 3 management rounds, 8 tasks, 2 attempts per task and 20 prompt calls per run. Unsuccessful or duplicate results skip memory updates; summaries remain limited to 2000 characters. Usage counters describe local activity, not exact remaining provider quota.
+
+Live stdout/stderr, process-tree cancellation, configurable timeouts, editable plan approval and continuation from incomplete steps preserve finished work and partial output. Agent claims are separated from observed file metadata and available command evidence. Optional verification uses quota; final synthesis is not an independent test.
+
+### Local reliability and documentation
+
+Single-instance forwarding, deferred project switching, unique atomic writes, interrupted-session recovery and summary-based history reduce storage conflicts and unnecessary reads. English, Turkish, German, Spanish and French READMEs include screenshots generated from the production renderer with synthetic data. Gemini remains disabled until explicit risk acceptance.
+
+### Validation and limits
+
+Offline tests cover coordination budgets, economic call counts, cancellation, timeout, process cleanup, continuation, plan validation and room state. Electron checks use mocked agents; no real subscription calls were made. Windows notification presentation depends on OS settings. macOS/Linux validation, automatic model discovery and Gemini thinking-level support remain pending. The installer remains unsigned and requires clean-account installation testing.
+
+## 1.0.0 — 2026-10-14
+
+Initial npm launcher release: launch the local Electron application from a project using `npx quotalala` or the globally installed `quotalala` command. Uses official authenticated CLIs and local project history/memory.
+
+## Updating
+
+After 1.1.0 is published, run `npx quotalala@latest`, or update a global installation with `npm install -g quotalala@latest`. This release does not add an in-app updater. Existing local sessions are retained; older saved plans keep their earlier execution flow.
+
+Screenshots can be regenerated with `npm run screenshots`. This renders only synthetic data and writes images inside the repository; no agent CLI is loaded.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quotalala Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.de.md

@@ -0,0 +1,166 @@
+<p align="center">
+  <img src="assets/icon.png" alt="Quotalala Q-Logo" width="104" height="104">
+</p>
+<h1 align="center">Quotalala</h1>
+<p align="center">Ein Prompt. Dein Projekt. Claude, Codex und optional Gemini.</p>
+<p align="center">
+  <a href="README.md">🇬🇧 English</a> · <a href="README.tr.md">🇹🇷 Türkçe</a> · <strong>🇩🇪 Deutsch</strong> · <a href="README.es.md">🇪🇸 Español</a> · <a href="README.fr.md">🇫🇷 Français</a>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/quotalala">npm</a> · <a href="LICENSE">MIT</a> · Windows · Node.js 22.12+
+</p>
+
+Quotalala ist eine lokale Electron-Desktop-App, die deine bereits angemeldeten KI-CLIs koordiniert. Starte sie in deinem Projekt und sende einen Prompt: Claude plant die Arbeit, verteilt Aufgaben und prüft die Ergebnisse. Gespeicherte Gespräche und die Projektzusammenfassung werden automatisch geladen.
+
+## Neu in 1.1.0
+
+Claude beantwortet Rückfragen, holt andere Agenten hinzu und vergibt gezielte Korrekturen. Der Teamraum zeigt echte Aufgabenereignisse ohne zusätzliche Agentenaufrufe.
+
+Sparmodus, bearbeitbare Planfreigabe, Live-Ausgabe, Stopp, einstellbare Zeitlimits und Fortsetzung unvollständiger Schritte sind enthalten. Ergebnisse trennen Agentenaussagen von beobachteten Belegen.
+
+Grenzen: 3 Koordinationsrunden, 8 Aufgaben, 2 Versuche je Aufgabe und 20 Prompt-Aufrufe je Durchlauf. Lokale Nutzungszähler sind weder Tokenzahlen noch genaue Abonnementkontingente.
+
+[Versionshinweise](CHANGELOG.md). Aktualisieren: `npx quotalala@latest` oder `npm install -g quotalala@latest`. Diese Funktionen erfordern mindestens 1.1.0; npm 1.0.0 enthält den bisherigen Funktionsumfang. Kein automatisches Update innerhalb der App.
+
+## Bildschirmfotos
+
+Produktionsoberfläche von Electron mit synthetischem Projekt und Nachrichten; keine Abonnementaufrufe oder privaten Projektverläufe. Die Oberfläche unterstützt Englisch und Türkisch.
+
+![Projektbereich und Live-Teamraum](assets/screenshots/workspace-en.png)
+
+<details>
+<summary>Bearbeitbarer Plan mit Agenten- und Stufenauswahl</summary>
+
+![Bearbeitbarer Plan mit Agenten- und Stufenauswahl](assets/screenshots/plan-approval-en.png)
+
+</details>
+
+<details>
+<summary>Türkischer Teamraum</summary>
+
+![Türkischer Teamraum](assets/screenshots/team-room-tr.png)
+
+</details>
+
+## Im Projekt starten
+
+Öffne ein Terminal **im gewünschten Projektordner**:
+
+```powershell
+npx quotalala
+```
+
+Oder installiere die App einmal und verwende den kurzen Befehl:
+
+```powershell
+npm install -g quotalala
+quotalala
+```
+
+Der aktuelle Ordner wird zum Arbeitsverzeichnis der Agenten, auch ohne `.git` oder Projektmanifest. Einen anderen Ordner öffnest du so:
+
+```powershell
+quotalala --project "C:\projects\my-app"
+```
+
+**Voraussetzungen:** Windows, Node.js 22.12+ sowie installierte und angemeldete `claude`- und `codex`-CLIs. Prüfe die Anmeldung mit `claude auth status` und `codex login status`. Der optionale Gemini-Agent nutzt `agy`. Bei der ersten npm-Installation wird Electron heruntergeladen; ein separater Quotalala-Installer und eine native Kompilierung sind nicht nötig. Der Befehl öffnet ein Desktop-Fenster.
+
+## Was sich ändert
+
+| Manuell | Mit Quotalala |
+| --- | --- |
+| Kontext für jeden Agenten wiederholen | Einen Prompt senden; Claude erstellt einen Plan |
+| Jede Aufgabe selbst zuweisen | Agent, Modellstufe und Begründung sehen |
+| Ergebnisse zwischen Tools kopieren | Der Koordinator gibt Aufgabenergebnisse weiter |
+| Den letzten Arbeitsstand rekonstruieren | Gespräche, Zeitleiste und bearbeitbare Projektzusammenfassung öffnen |
+
+1. **Planen:** Claude berücksichtigt den lokalen Kontingentstatus und den Projektkontext.
+2. **Ausführen:** Aufgaben gehen an Claude, Codex oder aktiviertes Gemini. Bei Kontingentfehlern kann eine Übergabe erfolgen; nicht verfügbare Modelle fallen auf das CLI-Standardmodell zurück.
+3. **Prüfen:** Claude führt die Ergebnisse zusammen. Die Zeitleiste zeigt Zuweisungen, Übergaben und Fehler mit aufklappbaren Ein- und Ausgaben.
+
+Die Verteilung basiert auf lokalen Nutzungs- und Fehlerdaten. Sie misst keine Anbieter-Kontingente in Echtzeit und garantiert keinen geringeren Verbrauch.
+
+## Ein kleines Teamzimmer
+
+Die Hauptansicht zeigt ein kleines Büro: Claude koordiniert, Codex entwickelt und optional Gemini recherchiert. Die Schreibtische reagieren auf echte Aufgabenereignisse, Fragen, Antworten, Abschluss und Abbruch. Sprechblasen und die Nachrichtenleiste öffnen kopierbare Nachrichten. Die bisherigen Gesundheits- und Modellkontrollen stehen unter den Verbindungsdetails; das Zimmer lässt sich einklappen.
+
+Die Darstellung verursacht **keine zusätzlichen CLI-Aufrufe**. Fragen und Antworten laufen weiterhin automatisch über Claude. Deaktiviertes Gemini bleibt aus. Verlauf und abgebrochene Arbeit zeigen keine Arbeitsanimation; reduzierte Bewegung wird unterstützt.
+
+Im Hintergrund melden leise Desktop-Benachrichtigungen fertige Ergebnisse, Hindernisse oder benötigte Planfreigaben. Ein Klick öffnet die passende Sitzung, ohne Arbeit zu starten oder zu wiederholen. Agentengespräche und manuelle Abbrüche bleiben still. Aufgabenbenachrichtigungen sind in den Einstellungen abschaltbar und enthalten keine Prompt- oder Antwortinhalte. Die Zustellung hängt von den Betriebssystemeinstellungen ab.
+
+## Claude führt das Team
+
+Im koordinierten Modus bleibt Claude nach dem ersten Plan verantwortlich. Agenten können Ergebnisse oder Fragen senden. Claude bewertet unabhängige Ergebnisse gemeinsam, beantwortet Fragen, beauftragt einen aktivierten Agenten mit einer gezielten Beratung oder legt eine konkrete Korrekturaufgabe an. Fragen, Entscheidungen und Antworten erscheinen kopierbar im Teamgespräch und in der Zeitleiste.
+
+Die letzte Koordinationsantwort enthält bereits die Synthese; ein zusätzlicher Synthese-Aufruf entfällt. Es gelten höchstens **3 Koordinationsrunden** auf leichter Stufe sowie insgesamt **8 Aufgaben, 2 Versuche je Aufgabe und 20 Aufrufe**. Auch Rückfragen und ihre Fortsetzung zählen als Versuche. Erledigte Schritte bleiben erhalten; Korrekturen sind eigene Schritte. Bei aktivierter Planvorschau müssen auch spätere Aufgaben und Antworten freigegeben werden.
+
+Pro Übergabe werden höchstens 3 relevante Auszüge mit je 1600 Zeichen geteilt. Neue Teamaufrufe nutzen frische CLI-Gespräche statt vollständiger alter Transkripte. Vollständige Ausgaben bleiben lokal; geteilte Auszüge können gekürzt werden. Ein Budgetende führt zu einem Teilergebnis. Alte gespeicherte Pläne behalten ihren bisherigen Ablauf. Gemini erfordert weiterhin die ausdrückliche Risikoannahme; geringerer Verbrauch ist keine Garantie.
+
+## Ausführung, Abbruch und Nachweise
+
+- **Sparmodus (Economic):** Agent und Stufe direkt auswählen. Ein erfolgreicher Lauf benötigt einen Prompt-Aufruf; Planung, Synthese, Speicheraktualisierung und Zusatzprüfung entfallen. Auch ohne Claude-Koordination nutzbar. Modell-/Sitzungsfallback kann einen weiteren Versuch benötigen.
+- **Planfreigabe:** Aufgaben, Prompts, Gründe und Agent/Stufe bearbeiten oder Aufgaben entfernen. Das Backend prüft den Plan und die verfügbaren Agenten erneut; Modelle stammen weiter aus dem verifizierten Katalog.
+- Höchstens **8 Teilaufgaben, 2 Versuche je Aufgabe, 20 Prompt-Aufrufe je Lauf**. Modellfallback und Übergabe teilen dasselbe Versuchslimit. Wiederholte fehlgeschlagene Operationen werden übersprungen. Timeout je Aufruf: **1–1800 Sekunden**, Standard 180; Hilfebefehle: 10 Sekunden.
+- Live-Ausgabe bleibt markierbar und kopierbar. **Stop** beendet den Prozessbaum und verwirft wartende Aufgaben. Abbruch, Fehler und Erfolg sind getrennt; Teilergebnisse bleiben erhalten. Fortsetzen verwendet den gespeicherten Plan und führt erfolgreiche Schritte nicht erneut aus. Nebenwirkungen unvollständiger Schritte werden nicht zurückgerollt.
+- Agentenaussagen und unbestätigte Ergebnisse werden getrennt angezeigt. Dateimetadaten, Datei-/Zeilenverweise und verfügbare CLI-Kommandos samt Exitcodes (derzeit Codex) sind sichtbar. Reviews benötigen Datei-/Zeilenbelege, allgemeine Erklärungen nicht. Die Synthese ist kein unabhängiger Test; eine optionale Zusatzprüfung verbraucht Kontingent.
+- Nach erfolgreichen koordinierten Durchläufen mit neuen Ergebnissen aktualisiert Claude eine bearbeitbare Zusammenfassung mit höchstens **2000 Zeichen**. Die Planung erhält maximal **20 Ereignisüberschriften**.
+- Eine zweite App-Instanz reicht den Projektwunsch an das bestehende Fenster weiter. Während aktiver Arbeit wartet der Wechsel; der Arbeitsordner der Aufgabe bleibt fest. Eindeutige temporäre Dateien sichern atomare JSON-Schreibvorgänge. Unterbrochene Sitzungen werden beim Start markiert und sind fortsetzbar.
+
+Dateimetadaten beweisen keine inhaltliche Korrektheit. Prüfungen ohne strukturierte CLI-Ereignisse bleiben Agentenaussagen. Manche CLIs puffern Ausgaben; bei einem Absturz kann die letzte Sekunde Live-Text fehlen. Wiederherstellung erfordert aktivierte Speicherung. Windows wurde getestet; macOS/Linux und große erstmalige Migrationen bleiben Einschränkungen.
+
+## Projektgedächtnis
+
+- Gespräche sind nach Projekt gruppiert. Sitzungen lassen sich öffnen, umbenennen, löschen oder fortsetzen.
+- Nach erfolgreichen koordinierten Durchläufen mit neuen Ergebnissen aktualisiert Claude eine bearbeitbare Zusammenfassung mit höchstens **2000 Zeichen**. Die Planung erhält maximal **20 Ereignisüberschriften**.
+- Ausgaben und Logs lassen sich markieren und kopieren. Filtere nach Schweregrad oder Agent; Fehlerkarten zeigen Lösungsvorschläge und kopierbare Rohdaten.
+
+`Ctrl+N` öffnet ein Gespräch, `Ctrl+Enter` sendet den Prompt. Die Benutzeroberfläche ist Türkisch oder Englisch; README-Übersetzungen erweitern die Oberflächensprachen nicht.
+
+## Lokale Daten und Berechtigungen
+
+Keine API-Schlüssel, kein Auslesen von Anmeldedateien, keine Proxys und kein Teilen von Konten. Prompts gehen über stdin an offizielle CLIs mit deinen eigenen Konten. Sitzungen und Projektzusammenfassungen liegen als JSON in `~/.quotalala/sessions/` und `~/.quotalala/memory/`. Einstellungen erlauben das Abschalten der Speicherung und Löschen des Verlaufs; die Zusammenfassung lässt sich bearbeiten oder zurücksetzen. CLIs können eigene Protokolle speichern.
+
+Erkennbare Schlüssel und Tokens werden vor dem Speichern maskiert. Die Mustererkennung findet nicht jedes Geheimnis; prüfe Diagnoseausgaben vor dem Teilen. Das Öffnen eines Ordners umgeht keine CLI-Sandbox. Ein erfolgreicher Prozessabschluss allein macht eine blockierte Prüfung nicht erfolgreich.
+
+> **Gemini ist standardmäßig deaktiviert.** Vor dem Aktivieren von `agy` muss der Risikohinweis auf der Agentenkarte bestätigt werden. Er erläutert gemeldete Kontoeinschränkungen im Zusammenhang mit automatisierter Nutzung. Ohne Verifikation auf dem Entwicklungsrechner werden keine Gemini-Modellnamen mitgeliefert.
+
+## Desktop-Installer
+
+Ein Windows-NSIS-Installer kann ebenfalls gebaut werden und benötigt kein Node.js:
+
+```powershell
+& "C:\path\to\Quotalala.exe" --project "C:\projects\my-app"
+```
+
+Startest du die EXE aus einem Ordner mit `.git`, `AGENTS.md` oder `package.json`, erkennt sie das Projekt. Andernfalls wird das letzte Projekt wiederhergestellt. Die Seitenleiste ermöglicht den Projektwechsel oder die erste Ordnerauswahl. Es wurde noch kein Installer-Release veröffentlicht; der lokal geprüfte Installer ist unsigniert.
+
+<details>
+<summary><strong>Entwicklung, Tests und Pakete</strong></summary>
+
+Im geklonten Quotalala-Repository:
+
+```powershell
+npm ci
+npm start
+npm test
+npm run test:ui
+npm run test:startup
+npm run test:instance
+npm run check
+npm run pack:cli
+npm run build -- --win --publish never
+```
+
+Mit `npm start -- --project "C:\projects\my-app"` testest du ein anderes Projekt. Tests nutzen simulierte CLIs und lokale Beispieldaten. Echte Kontingenttests benötigen ausdrückliche Zustimmung: [AGENTS.md](AGENTS.md).
+
+`pack:cli` erstellt ein eigenständiges npm-Archiv mit festgelegter Electron-Version und prüft die Dateiliste. Veröffentliche das erzeugte Archiv statt des Entwicklungsmanifests im Repository-Stamm. Beim NSIS-Build bleibt Electron eine Entwicklungsabhängigkeit. Die Paketbefehle veröffentlichen nicht automatisch.
+
+Modelle samt Quellenangaben liegen in `~/.quotalala/models.json` und sind in den Einstellungen bearbeitbar. Preview-Modelle werden nicht standardmäßig gewählt. Automatische Modellerkennung und Gemini-Denkstufen sind noch offen; macOS und Linux sind geplant.
+
+Release-Prüfungen und bekannte Hinweise zu Build-Abhängigkeiten: [RELEASE-CHECKLIST.md](RELEASE-CHECKLIST.md). Die App verwendet einen Renderer mit Sandbox, Kontextisolierung und eingeschränkter IPC-Brücke. Backend: `src/main/`; Oberfläche: `src/renderer/`.
+
+</details>
+
+## Lizenz
+
+[MIT](LICENSE) · Quotalala Contributors

package/README.es.md

@@ -0,0 +1,167 @@
+<p align="center">
+  <img src="assets/icon.png" alt="Logotipo Q de Quotalala" width="104" height="104">
+</p>
+<h1 align="center">Quotalala</h1>
+<p align="center">Un prompt. Tu proyecto. Claude, Codex y Gemini opcional.</p>
+<p align="center">
+  <a href="README.md">🇬🇧 English</a> · <a href="README.tr.md">🇹🇷 Türkçe</a> · <a href="README.de.md">🇩🇪 Deutsch</a> · <strong>🇪🇸 Español</strong> · <a href="README.fr.md">🇫🇷 Français</a>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/quotalala">npm</a> · <a href="LICENSE">MIT</a> · Windows · Node.js 22.12+
+</p>
+
+Quotalala es una aplicación de escritorio local con Electron que coordina tus CLI de IA con las sesiones ya iniciadas. Ábrela desde tu proyecto y escribe un prompt: Claude planifica el trabajo, reparte las tareas y revisa los resultados. Las conversaciones guardadas y la memoria del proyecto se cargan automáticamente.
+
+## Novedades de 1.1.0
+
+Claude responde preguntas, consulta a otros agentes y asigna correcciones concretas. La sala del equipo muestra eventos reales sin llamadas adicionales a los agentes.
+
+Incluye modo económico, aprobación del plan editable, salida en directo, Detener, tiempos de espera configurables y continuación de pasos incompletos. Los resultados distinguen afirmaciones del agente y pruebas observadas.
+
+Límites: 3 rondas de coordinación, 8 tareas, 2 intentos por tarea y 20 llamadas de prompt por ejecución. Los contadores locales no son tokens ni el saldo exacto de una suscripción.
+
+[Notas de versión](CHANGELOG.md). Actualiza con `npx quotalala@latest` o `npm install -g quotalala@latest`. Estas funciones requieren 1.1.0 o posterior; npm 1.0.0 mantiene las funciones anteriores. No se instala una actualización automática dentro de la aplicación.
+
+## Capturas de pantalla
+
+Interfaz real de Electron con proyecto y mensajes de ejemplo; sin llamadas de suscripción ni historial privado. La interfaz admite inglés y turco.
+
+![Espacio del proyecto y sala del equipo en directo](assets/screenshots/workspace-en.png)
+
+<details>
+<summary>Plan editable con selección de agente y nivel</summary>
+
+![Plan editable con selección de agente y nivel](assets/screenshots/plan-approval-en.png)
+
+</details>
+
+<details>
+<summary>Sala del equipo en turco</summary>
+
+![Sala del equipo en turco](assets/screenshots/team-room-tr.png)
+
+</details>
+
+## Inicia desde tu proyecto
+
+Abre una terminal **dentro de la carpeta del proyecto en el que quieres trabajar**:
+
+```powershell
+npx quotalala
+```
+
+O instala una vez y usa el comando corto:
+
+```powershell
+npm install -g quotalala
+quotalala
+```
+
+La carpeta actual será el directorio de trabajo de los agentes, incluso sin `.git` ni un archivo de configuración del proyecto. Para abrir otra carpeta:
+
+```powershell
+quotalala --project "C:\projects\my-app"
+```
+
+**Requisitos:** Windows, Node.js 22.12+ y las CLI `claude` y `codex` instaladas y con sesión iniciada. Comprueba el acceso con `claude auth status` y `codex login status`. El agente Gemini opcional utiliza `agy`. La primera instalación con npm descarga Electron; no necesitas otro instalador de Quotalala ni compilación nativa. El comando abre una ventana de escritorio.
+
+## Qué cambia
+
+| Trabajo manual | Con Quotalala |
+| --- | --- |
+| Repetir el contexto para cada agente | Enviar un prompt; Claude crea un plan |
+| Elegir quién hace cada tarea | Ver agente, nivel de modelo y motivo |
+| Copiar resultados entre herramientas | El coordinador transmite las salidas |
+| Reconstruir dónde te quedaste | Abrir conversaciones, cronología y memoria editable del proyecto |
+
+1. **Planificar:** Claude divide el trabajo usando el estado local de las cuotas y el contexto del proyecto.
+2. **Ejecutar:** Las tareas van a Claude, Codex o Gemini si está activado. Un error de cuota puede provocar una transferencia; si un modelo no está disponible, se usa el predeterminado de la CLI.
+3. **Revisar:** Claude reúne y comprueba los resultados. La cronología muestra asignaciones, transferencias y errores con entradas y salidas desplegables.
+
+La distribución usa registros locales de uso y errores de cuota. No mide las cuotas del proveedor en tiempo real ni garantiza un consumo menor.
+
+## Una pequeña sala de equipo
+
+La pantalla principal muestra una pequeña oficina: Claude coordina, Codex desarrolla y Gemini investiga si está habilitado. Los escritorios reflejan eventos reales de trabajo, preguntas, respuestas, finalización y cancelación. Pulsa un bocadillo o la franja de mensajes para abrir y copiar el mensaje. Los controles anteriores están en los detalles de conexiones y agentes; la sala puede contraerse.
+
+La vista **no añade llamadas a las CLI**. Las preguntas y respuestas siguen pasando automáticamente por Claude. Gemini desactivado permanece apagado. El historial y los trabajos cancelados no muestran animación de trabajo; se respeta la preferencia de movimiento reducido.
+
+Con la aplicación en segundo plano, las notificaciones silenciosas avisan de resultados, obstáculos o planes pendientes de aprobación. Al pulsarlas se abre la sesión correspondiente sin iniciar ni repetir trabajo. Las conversaciones entre agentes y las cancelaciones manuales no generan avisos. Las notificaciones de tareas se pueden desactivar en Ajustes y no incluyen prompts ni respuestas. Su entrega depende de la configuración del sistema operativo.
+
+## Claude dirige el equipo
+
+En modo coordinado, Claude mantiene el control después del plan inicial. Los agentes envían resultados o preguntas. Claude evalúa juntos los resultados independientes, responde al agente que espera, consulta a otro agente habilitado o crea una tarea de corrección concreta. Preguntas, decisiones y respuestas se muestran como texto seleccionable y copiable en la conversación del equipo y la cronología.
+
+La última respuesta de coordinación incluye la síntesis, sin otra llamada adicional. Se permiten **3 rondas de coordinación** con nivel ligero y un total de **8 tareas, 2 intentos por tarea y 20 llamadas**. Preguntar y continuar tras recibir una respuesta también consume intentos. Los pasos terminados se conservan; las correcciones son pasos nuevos. Con la vista previa activada, el trabajo y las respuestas de rondas posteriores también requieren aprobación editable.
+
+Cada transferencia comparte hasta 3 fragmentos relevantes de 1600 caracteres. Las nuevas llamadas del equipo usan conversaciones CLI nuevas con el contexto necesario; la salida completa queda guardada localmente. Los fragmentos largos pueden truncarse. Al agotarse un límite se entrega un resultado parcial. Los planes antiguos conservan su flujo anterior. Gemini sigue exigiendo aceptación explícita del riesgo; no se garantiza una reducción de cuota.
+
+## Ejecución, cancelación y evidencias
+
+- **Modo económico:** elige un agente y un nivel para ejecutar directamente. Una ejecución correcta usa una llamada de prompt; omite planificación, síntesis, memoria y verificación adicional. Permite trabajar sin coordinación de Claude. La alternativa de modelo/sesión puede añadir un intento.
+- **Aprobación del plan:** edita tareas, prompts, motivos y agente/nivel, o elimina tareas. El backend valida de nuevo el plan y la disponibilidad; los modelos siguen procediendo del catálogo verificado.
+- Máximo **8 subtareas, 2 intentos por tarea y 20 llamadas por ejecución**. Las alternativas de modelo y agente comparten ese límite. No se repite una operación que ya falló. Tiempo máximo por llamada: **1–1800 segundos**, 180 por defecto; ayuda: 10 segundos.
+- La salida en directo se puede seleccionar y copiar. **Detener** termina el árbol de procesos y no inicia tareas pendientes. Cancelación, error y éxito son estados distintos; se conservan los resultados parciales. Continuar reutiliza el plan y evita ejecutar otra vez los pasos correctos. No revierte los cambios de pasos incompletos.
+- Se separa lo declarado por el agente de lo no verificado independientemente. Se muestran metadatos de archivos, referencias de archivo/línea y comandos/códigos de salida expuestos por la CLI (actualmente Codex). Las revisiones requieren referencias; las explicaciones generales no. La síntesis no es una prueba independiente; la verificación adicional opcional consume cuota.
+- Tras ejecuciones coordinadas correctas con resultados nuevos, Claude actualiza un resumen editable de hasta **2000 caracteres**. La planificación recibe hasta **20 títulos de eventos**.
+- Una segunda instancia transmite el proyecto a la ventana existente. Si hay trabajo activo, espera; el directorio de la tarea no cambia. Los archivos temporales únicos protegen las escrituras atómicas. Las sesiones interrumpidas se detectan al iniciar y pueden continuarse.
+
+Los metadatos no prueban la corrección del contenido. Los controles sin eventos estructurados siguen siendo declaraciones del agente. Algunas CLI almacenan la salida hasta terminar; un cierre inesperado puede perder el último segundo de texto en directo. La recuperación requiere guardar el historial. Windows está probado; macOS/Linux y la primera migración de historiales grandes siguen pendientes.
+
+## Memoria del proyecto
+
+- Las conversaciones se agrupan por proyecto. Puedes abrir, renombrar, eliminar o continuar una sesión.
+- Tras ejecuciones coordinadas correctas con resultados nuevos, Claude actualiza un resumen editable de hasta **2000 caracteres**. La planificación recibe hasta **20 títulos de eventos**.
+- Se usa la continuación nativa de la CLI si el soporte está verificado y existe un identificador exacto de sesión. En caso contrario, la memoria aporta el contexto. No se importan otras conversaciones de las CLI.
+- Puedes seleccionar y copiar salidas y registros. Filtra por nivel o agente; las tarjetas de error incluyen una solución sugerida y la salida original para copiar.
+
+`Ctrl+N` abre una conversación y `Ctrl+Enter` envía el prompt. La interfaz está en turco e inglés; las traducciones del README no añaden idiomas a la interfaz.
+
+## Datos locales y permisos
+
+Sin claves API, lectura de archivos de credenciales, proxies ni cuentas compartidas. Los prompts se envían por stdin a las CLI oficiales con tus propias cuentas. Las sesiones y la memoria se guardan como JSON en `~/.quotalala/sessions/` y `~/.quotalala/memory/`. En Ajustes puedes desactivar el guardado o borrar el historial; la memoria se puede editar o restablecer. Las CLI pueden conservar sus propias transcripciones.
+
+Las claves y los tokens reconocibles se enmascaran antes de guardar. Los patrones no detectan todos los secretos; revisa los diagnósticos antes de compartirlos. Abrir una carpeta no evita las restricciones de la CLI. Un proceso que termina sin error no basta para considerar completada una revisión bloqueada.
+
+> **Gemini está desactivado de forma predeterminada.** Para activar `agy` hay que aceptar el aviso de riesgo de su tarjeta. El aviso explica las restricciones de cuentas notificadas en relación con el uso automatizado. No se incluyen nombres de modelos Gemini sin verificación en el equipo de desarrollo.
+
+## Instalador de escritorio
+
+También se puede generar un instalador NSIS para Windows, que no requiere Node.js:
+
+```powershell
+& "C:\path\to\Quotalala.exe" --project "C:\projects\my-app"
+```
+
+Si ejecutas la aplicación desde una carpeta con `.git`, `AGENTS.md` o `package.json`, detectará el proyecto. En caso contrario, recuperará el último proyecto. La barra lateral permite cambiar de proyecto o abrir la primera carpeta. Todavía no hay una Release con el instalador; el instalador verificado localmente no está firmado.
+
+<details>
+<summary><strong>Desarrollo, pruebas y empaquetado</strong></summary>
+
+Desde el repositorio Quotalala clonado:
+
+```powershell
+npm ci
+npm start
+npm test
+npm run test:ui
+npm run test:startup
+npm run test:instance
+npm run check
+npm run pack:cli
+npm run build -- --win --publish never
+```
+
+Usa `npm start -- --project "C:\projects\my-app"` para probar otro proyecto. Las pruebas utilizan CLI simuladas y datos locales de ejemplo. Las pruebas de cuota reales requieren permiso explícito: [AGENTS.md](AGENTS.md).
+
+`pack:cli` genera un archivo npm independiente con una versión fijada de Electron y valida su lista de archivos. Publica el archivo generado, no el manifiesto de desarrollo de la raíz. En la compilación NSIS, Electron sigue siendo una dependencia de desarrollo. Estos comandos no publican automáticamente.
+
+Los modelos y sus fuentes están en `~/.quotalala/models.json`, editable en Ajustes. Los modelos preview no se eligen de forma predeterminada. El descubrimiento automático de modelos y los niveles de razonamiento de Gemini siguen pendientes. El soporte para macOS y Linux está previsto.
+
+Comprobaciones de publicación y avisos conocidos de dependencias de compilación: [RELEASE-CHECKLIST.md](RELEASE-CHECKLIST.md). La aplicación usa un renderer aislado, aislamiento de contexto y un puente IPC limitado. Backend: `src/main/`; interfaz: `src/renderer/`.
+
+</details>
+
+## Licencia
+
+[MIT](LICENSE) · Quotalala Contributors