README.de.md

Codewhale

Codewhale ist ein Open-Source-Agent, der dein Projekt liest, Dateien bearbeitet, Befehle ausführt und seine Arbeit mit einem gehosteten oder lokalen Modell deiner Wahl prüft. Starte mit einer Aufgabe im Terminal. Teile eine größere Aufgabe auf Agenten mit verschiedenen Modellen und Rollen auf.

Terminalvorschau aus einem Entwicklungsbuild von v0.9.12.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

Installation

Für eine neue Installation unter macOS oder Linux verwende die offizielle GitHub-Version:

curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"

Das Installationsprogramm wählt die neueste veröffentlichte Version aus. Das Änderungsprotokoll beschreibt auch den noch unveröffentlichten Kandidaten für die nächste Version; diese Änderungen sind erst in den veröffentlichten Downloads enthalten, wenn die Version verfügbar ist.

Unter Windows lade das passende Installationsprogramm oder Archiv von GitHub Releases herunter. Bestehende direkte Installationen aktualisierst du mit codewhale update; codewhale update --check prüft nur. Der Updater zeigt den Pfad der ausführbaren Datei und behält neuere Builds bei. npm und Cargo sind nachrangige Paketoptionen. Hinweise zur Migration aus einer Paketverwaltung und zu PATH stehen in der Installationsanleitung.

Beim ersten Start hilft dir Codewhale, einen Anbieter zu verbinden oder Codewhale offline einzurichten. Antworten erfordern ein verbundenes gehostetes oder lokales Modell. Codewhale unterstützt außerdem npm und Cargo als nachrangige Paketoptionen sowie Docker, Nix, Scoop, Android/Termux und einen optionalen CNB-Spiegel. Bestehende Installationen über Paketverwaltungen erhalten Migrationshinweise. Siehe die Hilfe zu Installation und PATH.

Die Tab-Vervollständigung lässt sich für jede Shell mit einem einzigen Befehl aktivieren — codewhale completion bash|zsh|fish|powershell|elvish. Siehe Shell-Vervollständigung.

Verwendung

Öffne ein Terminal im Ordner deines Projekts und starte codewhale. Wähle deinen Anbieter mit /provider und dein Modell mit /model. Beschreibe dann eine konkrete Aufgabe:

Fix the failing tests and explain what changed.

Du kannst eine Aufgabe auch ausführen, ohne die TUI zu öffnen:

codewhale exec "fix the failing tests and explain what changed"

Codewhale kann dein Repository lesen, Dateien bearbeiten, Befehle ausführen, Ergebnisse prüfen und auf ein Ziel hinarbeiten. Nutze /mode plan, um ohne Dateiänderungen oder Shell-Ausführung zu erkunden, und /mode work, wenn der Agent Änderungen vornehmen soll. Drücke Shift+Tab, um Ask, Auto-Review oder Full Access auszuwählen; die Anleitung zu Modi und Berechtigungen erklärt, was jeweils erlaubt ist.

Terminal, Apps und Computer Use

Das Terminal und die grafischen Clients verbinden sich mit der Codewhale Runtime, die den Agenten und seine Werkzeuge ausführt:

• Terminal: codewhale öffnet die interaktive Oberfläche; codewhale exec führt eine Aufgabe aus einem Skript oder CI-Job aus.
• Lokaler Browser: codewhale web öffnet den mitgelieferten lokalen Webclient für dieselbe Runtime.
• Web- und Desktop-Apps von Codewhale: grafische Arbeitsumgebungen in Entwicklung. Ihre Verfügbarkeit ist auf der Produktseite angegeben.

Computer Use ergänzt Werkzeuge zum Beobachten anderer Anwendungen und zur Interaktion mit ihnen. Das Plugin ist im aktuellen Quellcode enthalten. Prüfe die angeforderten Zugriffsrechte und aktiviere es vor der Verwendung; Betriebssystemberechtigungen und Plattformanforderungen gelten weiterhin. Siehe die mitgelieferte Anleitung zu Computer Use und die Plugin-Einrichtung.

Für VS Code verbindet sich die von der Community gepflegte CodeWhale-Erweiterung über eine Seitenleiste mit der lokalen Runtime. Installiere sie aus dem VS Code Marketplace; der Quellcode liegt auf GitHub.

Warum Codewhale

• Wähle deine Modelle. Verbinde gehostete Anbieter oder lokale Modelle über Ollama, vLLM oder SGLang. Mit /provider wechselst du den Anbieter, mit /model wählst du ein Modell.
• Behalte die Kontrolle. Prüfe vorgeschlagene Aktionen und die daraus entstehenden Dateiänderungen. Die Genehmigungseinstellungen bestimmen, wann eine Prüfung nötig ist; Full Access beachtet weiterhin die verbindlichen Grenzen der Richtlinien. /undo und /restore helfen bei der Wiederherstellung von Änderungen im Arbeitsbereich.
• Halte lange Arbeiten übersichtlich. Speichere Sitzungen, setze ein dauerhaftes /goal, prüfe Workflows vor der Ausführung und koordiniere Agenten, ohne dass ihre internen Anweisungen in deinem Gesprächsverlauf erscheinen.
• Erweitere deinen vorhandenen Agenten. Verbinde MCP-Server und Skills, konfiguriere Hooks und verwalte Agentenrollen als lesbare Dateien in deinem Projekt oder in deinen persönlichen Einstellungen.

Führe /help in der TUI aus, um Befehle und Tastenkürzel anzuzeigen.

Sicherheit

Codewhale läuft auf deinem Rechner mit den von dir gewährten Zugriffsrechten. Genehmigungsmodi und Repository-Regeln begrenzen, was der Agent tun darf; optionales OS-Sandboxing schafft auf unterstützten Systemen eine stärkere Ausführungsgrenze. Unbekannte Modellpreise bleiben als unbekannt gekennzeichnet, statt als kostenlos gemeldet zu werden.

Lies die Autorisierungsreihenfolge für die genaue Richtlinienhierarchie und die Konfiguration für lokale Einstellungen.

Dokumentation

• Anbieter und lokale Modelle
• Agententeams
• MCP, Hooks und Konfiguration
• Lokaler Webclient
• Gesamte Dokumentation
• Aufbau des Repositorys und Anleitung zum Mitwirken

Der Community beitreten

Fehlerberichte, Funktionsideen und Pull Requests sind willkommen, egal ob du Codewhale seit Monaten nutzt oder zum ersten Mal ausprobierst. Wenn ein Anbieter fehlt, ein Workflow umständlich ist oder dir die Terminaloberfläche im Weg steht, eröffne ein Issue oder sende einen Pull Request, damit wir es gemeinsam verbessern können. Erste Beiträge sind willkommen, und Mitwirkende behalten die Anerkennung für ihre übernommenen Arbeiten.

Tritt unserem Discord bei oder füge Hunter auf WeChat (hunterbown) hinzu und bitte um Aufnahme in die Whale-Brothers-Gruppe.

Projektgeschichte

Codewhale begann als deepseek-tui und bewahrt weiterhin die Kompatibilität mit dessen Konfiguration und Sitzungen. Heute ist es anbieterneutral, wird unabhängig gepflegt und ist mit keinem Modellanbieter verbunden.

Vielen Dank an alle Mitwirkenden und die Open-Source-Communitys, die das Projekt beim Wachsen unterstützt haben. Siehe Liste der Mitwirkenden.

Lizenz

MIT. Aus anderen Open-Source-Projekten übernommene Teile sind in den Hinweisen zu Drittanbieterkomponenten aufgeführt.