# CodeWhale Quelloffener Programmier-Agent fürs Terminal, früher DeepSeek-TUI, der mit vielen Modellanbietern und lokalen Modellen arbeitet. Kanonisches Profil: https://ki-agentenkompass.de/agenten/codewhale/ Redaktion: [Michael Meierhoff](https://ki-agentenkompass.de/ueber-mich/) Quellenabgleich: 2026-11-05 Basis: Anbieter-Dokumentation. Praxisbeispiele sind redaktionelle Vorschläge, keine eigenen Produkttests. ## Einordnung Das Projekt hieß zuerst deepseek-tui und läuft seit v0.8.41 (23. Mai 2026) als Codewhale. Das Repository liegt jetzt unter codewhale-hq; die alten Pfade unter Hmbown leiten dorthin weiter. Laut README ist es unabhängig und nicht mit DeepSeek oder anderen Modellanbietern verbunden, auch wenn DeepSeek der Standardanbieter ist. DeepSeek Harness führt der Katalog getrennt. - Anbieter: Shannon Labs - Produktfamilie: CodeWhale - Profiltyp: Quelloffener Terminal-Agent zum Programmieren - Umgebung: Terminal, lokale Web-Oberfläche auf 127.0.0.1, Headless per `codewhale exec`, lokale Runtime-API und ACP; Linux, macOS und Windows auf x64 und arm64 - Verbindungen: Mehr als 40 eingebaute Anbieter, OpenAI-kompatible Endpunkte, Ollama, vLLM und SGLang; MCP, Skills, Plugins, Hooks, ACP, Runtime-API und GitHub-Prüfbot - Einrichtung: Per Installationsskript, winget, npm (Node.js ab 18) oder Cargo (Rust ab 1.89) installieren, im Git-Repository starten und über `/provider` einen Schlüssel oder ein lokales Modell wählen. Das Skript braucht curl oder wget und ein SHA-256-Werkzeug, aber weder Node noch Rust. - Kostenmodell: Laut README kostenlos und MIT-lizenziert. Mit eigenem Schlüssel zahlst du direkt beim Anbieter, lokale Modelle brauchen keinen Schlüssel. ## Kernfunktionen ### Aufträge im Terminal Du gibst eine Aufgabe, Codewhale liest das Repository, bearbeitet Dateien und führt Befehle aus, bis die Aufgabe erledigt ist oder es deine Eingabe braucht. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Viele Modelle, auch lokal Mehr als 40 Anbieter sind eingebaut, Standard ist deepseek-flash. `/model` wechselt zwischen Zügen, `/model auto` wählt je Zug ein Modell. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Modi Plan, Work und Operate Plan liest nur und ändert nichts. Work bearbeitet Dateien und führt Befehle aus. Operate hat dieselben Rechte und arbeitet an einem Ziel, bis es geprüft ist oder deine Eingabe nötig ist. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/MODES.md ### Belege und Rücknahme `/receipts` listet geänderte Dateien, Befehle, Web- und MCP-Aufrufe, Freigaben und Fehler. `/undo` nimmt den letzten Auftrag samt Dateiänderungen zurück. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/RECEIPTS.md ### Unteragenten, Fleet und Workflows Aufgaben lassen sich auf Rollen wie explore, implement oder reviewer verteilen. Workflows ergänzen Reihenfolge, Ergebnisübergaben und Prüfpunkte. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/SUBAGENTS.md ### Prüfung von Pull Requests `codewhale review --pr` erstellt eine beratende Prüfung. Der GitHub-Bot veröffentlicht Befunde mit getrennten Jobs und führt laut Doku keinen Code des Pull Requests aus. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GITHUB_ACTION.md ### Berechtigungen und Sandbox Stufen Ask, Auto-Review und Full Access. In Ask und Auto-Review laufen Befehle in einer OS-Sandbox, soweit vorhanden: Seatbelt auf macOS, bubblewrap auf Linux, wenn installiert. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/SANDBOX.md ## Redaktionelle Praxisbeispiele ### Tests reparieren - Du gibst vor: Ein sauberer Git-Stand und der Auftrag, fehlschlagende Tests zu beheben. - Mögliches Ergebnis: Codewhale ändert Dateien, führt nach Freigabe Befehle aus und erklärt die Änderung. - Das prüfst du: Diff und `/receipts` prüfen, bei Bedarf `/undo` nutzen. ### Aufgabe in CI ausführen - Du gibst vor: `codewhale exec --auto --sandbox workspace-write` mit eigenem Modellschlüssel. - Mögliches Ergebnis: Eine Aufgabe läuft ohne Oberfläche und lässt sich danach über Belege nachvollziehen. - Das prüfst du: Die Sandbox ausdrücklich setzen und `codewhale receipts --last` auswerten. ## Voraussetzungen und Grenzen ### Modellzugang nötig Voraussetzung: Laut Installationsanleitung tut Codewhale ohne Modell nichts Sinnvolles. Du brauchst den Schlüssel eines Anbieters oder ein lokales Modell. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/INSTALL.md ### Reifegrad vor Version 1.0 Einschränkung: Aktuell ist v0.10.2, als reguläres Release markiert. Sicherheitskorrekturen gibt es nur für die jeweils neueste stabile Version. Die Änderungsliste ist lang und kurz getaktet; mehrere Teile tragen die Kennzeichnung experimentell oder Vorschau. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/.github/SECURITY.md ### Standardverhalten beachten Einschränkung: In Ask laufen Dateiänderungen im Repository ohne Nachfrage. `exec --auto` nutzt standardmäßig Full Access ohne Sandbox, außer du setzt `--sandbox workspace-write`. Windows hat noch keine OS-Sandbox. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Stand des gehosteten Angebots Noch offen: Die Website führt eine gehostete Web-App als in Entwicklung, das Handbuch beschreibt ihre stufenweise Abschaltung seit September 2026. Die Datenschutzerklärung behandelt Konten und gemanagte Modelle. Wie weit das heute nutzbar ist, bleibt offen. Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md ## Passt, wenn … - du einen quelloffenen Terminal-Agenten ohne Pflichtkonto suchst - du Anbieter frei wählen oder lokale Modelle nutzen willst - du nachvollziehen möchtest, was ein Lauf geändert und ausgeführt hat ## Passt eher nicht, wenn … - du eine verwaltete Plattform mit Vertrag, Rollen und Zusagen zum Datenstandort brauchst - du unter Windows auf eine OS-Sandbox angewiesen bist - du dich nicht um Standardwerte zu Telemetrie und Freigaben kümmern willst Redaktionelle Einschätzung auf Basis der Anbieterangaben. Kein Produkttest. ## Nutzbare KI-Modelle Frei wählbar Über 40 Anbieter sind eingebaut, dazu OpenRouter, und jeder OpenAI-kompatible Endpunkt funktioniert. Lokal läuft CodeWhale mit Ollama, vLLM oder SGLang, ohne Schlüssel. Du wählst das Modell selbst oder lässt es mit /model auto je Schritt bestimmen. - Genannte Modellfamilien: Anthropic (Claude), OpenAI (GPT), DeepSeek, Google (Gemini), Mistral, Moonshot (Kimi), xAI (Grok) · Weitere Modelle frei anbindbar - Modellwahl: Automatisch oder selbst - Eigener API-Schlüssel: Ja - Router oder eigener Endpunkt: Ja - Lokale Modelle: Ja Belegt · Quellen abgerufen am: 2026-11-05 - [CodeWhale: README](https://github.com/codewhale-hq/Codewhale/blob/main/README.md) ## Europa & regionale Verfügbarkeit README, Telemetrie-Doku und Datenschutzerklärung (Stand 4. Oktober 2026) gelesen. Die Erklärung enthält keinen Abschnitt zur EU, zum EWR, zum Vereinigten Königreich oder zur Schweiz. Geprüfter Umfang: Lokales Programm; gehostete Konten getrennt betrachtet Sichtung am: 2026-11-05 ### Datenweg bei eigenem Schlüssel Mit Voraussetzungen Anfrageinhalte gehen an den Anbieter, den du verbindest, unter dessen Bedingungen. Standardanbieter ist DeepSeek. Lokale Modelle über Ollama, vLLM oder SGLang brauchen keinen Anbieter-Schlüssel. Betroffene Region: EU/EWR, Vereinigtes Königreich und Schweiz Belegter Grund: Standort und Verarbeitung richten sich nach dem gewählten Anbieter; Codewhale nennt dazu keine Zusage. Offizielle Quelle: https://codewhale.net/en/legal/privacy Offizielle Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Konten und Standort Verfügbarkeit noch ungeklärt Die Erklärung beschreibt ein globales Produkt ohne Standortwahl. Anmelde- und Sitzungsdaten liegen in Cloudflare Durable Objects, derzeit in der US-Jurisdiktion konfiguriert. Für das lokale Programm ist kein Konto nötig. Betroffene Region: EU/EWR, Vereinigtes Königreich und Schweiz Belegter Grund: Zusagen für europäische Nutzer nennt die Erklärung nicht. Offizielle Quelle: https://codewhale.net/en/legal/privacy ### Nutzungszählung Mit Voraussetzungen Die Zählung ist standardmäßig an und sendet zusammengefasste Werte mit einer zufälligen ID, die alle 90 Tage wechselt. Inhalte, Code und Zugangsdaten sind ausgeschlossen. PostHog kann als Auftragsverarbeiter dienen. `codewhale config set telemetry false` schaltet sie ab. Betroffene Region: EU/EWR, Vereinigtes Königreich und Schweiz Belegter Grund: Abschaltbar; einen europäischen Standort nennt die Doku nicht. Offizielle Quelle: https://github.com/codewhale-hq/Codewhale/blob/main/docs/TELEMETRY.md Offizielle Quelle: https://codewhale.net/en/legal/privacy ## Konten & Berechtigungen Angaben aus Anbieter-Dokumentation. Rechte hängen von Konto, Integration und Organisationsrichtlinien ab. Prüfe vor dem Einsatz die tatsächlich angeforderten Berechtigungen. Betrachtete Konfiguration: Lokales Programm ohne Pflichtkonto Quellenstand: 2026-11-05 ### Verwendetes Konto Dokumentiert: Du brauchst laut README kein Konto. Schlüssel aus `/provider` bleiben auf deinem Rechner. Experimentell lässt sich ein ChatGPT-Plan statt eines API-Schlüssels nutzen. Rollen oder SSO für das lokale Programm beschreibt das README nicht. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Admin-Freigabe Dokumentiert: Ask fragt vor nicht lesenden Befehlen; `y` einmal, `a` für ähnliche Befehle in der Unterhaltung, `n` lehnt ab. Auto-Review lässt Regeln und ein Prüfmodell Routineaufrufe freigeben. Full Access fragt nie. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/MODES.md ### Datenzugriff & Teamfreigaben Bedingt dokumentiert: Innerhalb der Sandbox dürfen Befehle keine Zugangsdaten wie `~/.ssh`, `~/.aws` oder `.env` lesen. Full Access schaltet die Sandbox ab, und auf Windows gibt es noch keine. Unteragenten bekommen eingegrenzte Rechte. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/SUBAGENTS.md ## Preise und enthaltene Nutzung Preisstand: 2026-11-05 Das Programm ist kostenlos. Für Terminal, lokale Web-Oberfläche und GUI brauchst du laut Website kein Konto. Kosten entstehen beim gewählten Modellanbieter. ### Codewhale Kostenlos unter MIT-Lizenz Terminal, lokale Web-Oberfläche, Headless und Runtime-API; ohne Modellnutzung. Preisquelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Eigener Anbieter-Schlüssel Nach Preisliste des Anbieters `/cost` zeigt die Sitzungskosten, wenn der Preis bekannt ist. Preisquelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md Website und README werben für ein Angebot von OrcaRouter; laut README erhält Codewhale dafür eine Vermittlungsgebühr. Preisangaben Dritter wurden nicht als Beleg verwendet. Preise und Tarifdetails: https://codewhale.net/ ## Betrieb & Betreuungsbedarf Basis: öffentliche Anbieter-Dokumentation. Einschätzungen sind redaktionelle Ableitungen aus den genannten Eigenschaften. Tatsächlicher Zeitaufwand und Zuverlässigkeit wurden nicht gemessen. Betrachtete Betriebsform: Lokaler Prozess; Modellaufrufe gehen an den gewählten Anbieter Quellenstand: 2026-11-05 ### Dateien und Arbeitsstand Dokumentiert: Neue Installationen schreiben nach `~/.codewhale/`; alte Daten aus `~/.deepseek/` bleiben lesbar. Sitzungen werden gespeichert, `/restore` setzt den Arbeitsbereich auf eine frühere Momentaufnahme zurück. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/REBRAND.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md ### Anmeldungen Dokumentiert: Schlüssel gibst du über `/provider` ein, sie bleiben lokal. Die Sandbox sperrt Zugangsdaten für Befehle. Eine Vorschau mit `/preview-request` zeigt die nächste Anfrage geschwärzt, ohne sie zu senden. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Start weiterer Läufe Bedingt dokumentiert: Operate bietet wiederkehrende Arbeit als Automation an, die nach deiner Freigabe entsteht. Automationen dürfen nicht mehr Rechte haben als die erzeugende Sitzung. GitHub-Workflows starten Prüfungen auf Ereignis. Welche Zeitpläne genau möglich sind, nennt das README nicht. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/MODES.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/CHANGELOG.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GITHUB_ACTION.md ### Menschliche Eingriffe Dokumentiert: Freigaben hängen an der Stufe. Plan verweigert Änderungen zentral und fragt am Ende, wie es weitergeht. Jeder Wechsel der Berechtigung erscheint im Verlauf. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/MODES.md ### Fehler erkennen Dokumentiert: `/receipts` listet Fehlschläge und wer was freigegeben hat. `/turn inspect` zeigt Modell, Kosten und Dauer eines Zugs. `codewhale doctor` prüft die Installation. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/RECEIPTS.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md ### Nach Fehlern fortsetzen Dokumentiert: Sitzungen lassen sich laut Handbuch fortsetzen und verzweigen, `exec --continue` setzt Headless-Läufe fort. `/undo` und `/restore` nehmen Änderungen zurück; `/restore` überschreibt spätere Bearbeitungen und braucht Vertrauensmodus oder Full Access. Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md Nachweis: https://github.com/codewhale-hq/Codewhale/blob/main/README.md ### Redaktionelle Einschätzung Codewhale legt offen, was es getan hat, und nimmt Änderungen zurück. Die Standardwerte verlangen Aufmerksamkeit: Dateiänderungen ohne Nachfrage, Zählung eingeschaltet, Full Access bei `exec --auto`. Das Projekt steht vor Version 1.0 und veröffentlicht in kurzen Abständen. ## Gedächtnis und Gesprächskontinuität Geltungsbereich: Lokales Memory, standardmäßig aus Quellen abgerufen: 2026-11-05 Markdown-Dateien mit SQLite-Suche, global oder je Repository; einschaltbar, offline und per Befehl verwaltbar. ### Speicherort und Umfang Belegt: Memory ist standardmäßig aus. Eingeschaltet liegt es unter `~/.codewhale/memory/` als Markdown mit einem SQLite-Suchindex. Es synchronisiert sich nicht in die Cloud, Einträge gehen aber als Prompt-Kontext an den gewählten Anbieter. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) ### Auswahl und Speicherzeitpunkt Belegt: Du fügst mit `#` im Eingabefeld oder `/memory native remember` hinzu. Das Modell kann das Werkzeug `remember` ohne Freigabe nutzen. Geheimnisse und flüchtige Aufgabenstände gehören laut Doku nicht hinein. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) ### Einsicht, Bearbeiten und Löschen Belegt: `/memory native` kann suchen, lesen, exportieren, neu indizieren und löschen, auch alles auf einmal. Die Dateien sind einfacher Text und lassen sich direkt bearbeiten. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) ### Agenten- und Kanalgrenzen Teilweise belegt: Bereiche sind global und Workspace; die Workspace-ID ist ein Hash des Git-Origins, Notizen eines Repositorys erscheinen laut Doku nicht in einem anderen. Grenzen zwischen Agenten oder Kanälen beschreibt die Seite nicht. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) ### Wiederabruf Belegt: Bis zu 32 Einträge oder 12.000 Zeichen kommen als markierter, nicht vertrauenswürdiger Block in den Systemprompt. Darüber hinaus sucht das Modell mit `memory_search` und `memory_get`. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) ### Session-Reset und Compaction Teilweise belegt: Der Memory-Stand zu Sitzungsbeginn gehört zum festen Prompt-Anfang, spätere Änderungen werden im Verlauf ergänzt. `/compact` fasst langen Kontext zusammen. Ob Memory das überdauert, ergibt sich aus der Dateiablage; eine eigene Reset-Regel nennt die Seite nicht. - [Codewhale: User Memory](https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md) - [Codewhale: User guide](https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md) ## Rahmen Vor Version 1.0. Dateiänderungen im Repository laufen standardmäßig ohne Nachfrage, also vorher committen. Nutzungszählung ist standardmäßig an. Windows hat noch keine OS-Sandbox. Du brauchst einen Modellzugang. Repository (README, Doku, Changelog, Release-Liste per GitHub-API), Website und Datenschutzerklärung gelesen; die Weiterleitung des alten Repository-Pfads per HTTP-Abruf geprüft. Das Projekt schreibt sich meist Codewhale, teils CodeWhale. Funktionsangaben stammen vom Projekt; Beispielaufträge sind redaktionell. Eigene Praxistests stehen aus. ## Offene Punkte Europa, Verfügbarkeit noch ungeklärt: - Konten und Standort Voraussetzungen und Grenzen, noch offen: - Stand des gehosteten Angebots ## Quellen - https://codewhale.net/ - https://github.com/codewhale-hq/Codewhale - https://github.com/Hmbown/DeepSeek-TUI - https://github.com/codewhale-hq/Codewhale/releases - https://github.com/codewhale-hq/Codewhale/blob/main/docs/REBRAND.md - https://github.com/codewhale-hq/Codewhale/blob/main/CHANGELOG.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/INSTALL.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/LEGACY_PATHS.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/FLEET.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/RUNTIME_API.md - https://codewhale.net/en/legal/privacy - https://github.com/codewhale-hq/Codewhale/blob/main/README.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/MODES.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/RECEIPTS.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/SUBAGENTS.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/GITHUB_ACTION.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/SANDBOX.md - https://github.com/codewhale-hq/Codewhale/blob/main/.github/SECURITY.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/GUIDE.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/TELEMETRY.md - https://github.com/codewhale-hq/Codewhale/blob/main/docs/MEMORY.md ## Anbieter Die Datenschutzerklärung nennt Codewhale ein Produkt von Shannon Labs, Inc. Das README führt Hunter als Maintainer; das Projekt nimmt Beiträge aus der Gemeinschaft an. - Betreiber: Shannon Labs - Organisation: Projekt und Betreiber - Website: https://codewhale.net - Stand: 2026-11-05 - Anbieterquelle: https://codewhale.net/en/legal/privacy - Anbieterquelle: https://github.com/codewhale-hq/Codewhale/blob/main/README.md [Quellen und Methode](https://ki-agentenkompass.de/quellen/)