Codewhale

Codewhale est un agent open source qui lit votre projet, modifie des fichiers, exécute des commandes et vérifie son travail avec un modèle hébergé ou local de votre choix. Commencez par une tâche dans votre terminal. Pour un travail plus important, confiez-en des parties à des agents utilisant différents modèles et rôles.

Aperçu du terminal dans une version de développement de la v0.9.12.

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

Installation

Pour une nouvelle installation sur macOS ou Linux, utilisez la version officielle de GitHub :

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

L’installeur sélectionne la dernière version publiée. Le journal des modifications décrit aussi la version candidate, encore non publiée, de la prochaine version ; ces modifications ne sont incluses dans les téléchargements publiés qu’une fois la version disponible.

Sur Windows, téléchargez l’installeur ou l’archive adaptés depuis GitHub Releases. Pour une installation directe existante, lancez codewhale update, ou codewhale update --check pour vérifier sans installer. L’outil affiche le chemin de l’exécutable et conserve les versions de développement plus récentes. npm et Cargo sont des options secondaires ; consultez le guide d’installation pour migrer depuis un gestionnaire de paquets et configurer PATH.

Au premier lancement, Codewhale vous aide à connecter un fournisseur ou à configurer Codewhale hors ligne. Les réponses nécessitent un modèle hébergé ou local connecté. Codewhale prend aussi en charge npm et Cargo comme options de distribution secondaires, ainsi que Docker, Nix, Scoop, Android/Termux et un miroir CNB facultatif. Les installations existantes gérées par un gestionnaire de paquets reçoivent des instructions de migration. Consultez l’aide à l’installation et à la configuration du PATH.

L’autocomplétion avec Tab s’active avec une commande par shell — codewhale completion bash|zsh|fish|powershell|elvish. Consultez l’autocomplétion du shell.

Utilisation

Ouvrez un terminal dans le dossier de votre projet et lancez codewhale. Choisissez votre fournisseur avec /provider et votre modèle avec /model. Décrivez ensuite une tâche concrète :

Fix the failing tests and explain what changed.

Vous pouvez aussi exécuter une tâche sans ouvrir la TUI :

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

Codewhale peut lire votre dépôt, modifier des fichiers, exécuter des commandes, inspecter les résultats et continuer à travailler vers un objectif. Utilisez /mode plan pour explorer sans modifier de fichiers ni exécuter de commandes shell, et /mode work lorsque vous souhaitez qu’il effectue des modifications. Appuyez sur Shift+Tab pour choisir Ask, Auto-Review ou Full Access ; le guide des modes et des permissions explique ce que chaque option autorise.

Terminal, applications et Computer Use

Le terminal et les clients graphiques se connectent au Runtime Codewhale, qui exécute l’agent et ses outils :

• Terminal : codewhale ouvre l’interface interactive ; codewhale exec exécute une tâche depuis un script ou une tâche de CI.
• Navigateur local : codewhale web ouvre le client web local fourni, qui utilise le même runtime.
• Applications web et de bureau Codewhale : des espaces de travail graphiques en développement. Leur disponibilité est indiquée sur la page du produit.

Computer Use ajoute des outils pour observer d’autres applications et interagir avec elles. Le plugin est inclus dans le code source actuel. Examinez les accès demandés et activez-le avant de l’utiliser ; les permissions du système d’exploitation et les exigences de la plateforme s’appliquent toujours. Consultez le guide Computer Use inclus et la configuration des plugins.

Pour VS Code, l’extension CodeWhale maintenue par la communauté se connecte au Runtime local depuis une barre latérale. Installez-la depuis le marketplace VS Code ; le code source est sur GitHub.

Pourquoi Codewhale

• Choisissez vos modèles. Connectez des fournisseurs hébergés ou des modèles locaux via Ollama, vLLM ou SGLang. Utilisez /provider pour changer de fournisseur et /model pour choisir un modèle.
• Gardez le contrôle. Examinez les actions proposées et les modifications de fichiers qui en résultent. Les paramètres d’approbation déterminent quand un examen est nécessaire ; Full Access respecte toujours les limites impératives des politiques. /undo et /restore aident à récupérer les modifications de l’espace de travail.
• Organisez les travaux de longue durée. Enregistrez les sessions, définissez un /goal durable, examinez les workflows avant leur exécution et coordonnez des agents sans faire apparaître leurs instructions internes dans votre conversation.
• Étendez l’agent que vous possédez déjà. Connectez des serveurs MCP et des compétences, configurez des hooks et conservez les rôles d’agent sous forme de fichiers lisibles dans votre projet ou vos paramètres personnels.

Exécutez /help dans la TUI pour afficher les commandes et les raccourcis clavier.

Sécurité

Codewhale s’exécute sur votre machine avec les accès que vous lui accordez. Les modes d’approbation et les règles du dépôt limitent les actions de l’agent ; un bac à sable facultatif du système d’exploitation renforce la limite d’exécution lorsqu’il est pris en charge. Le prix d’un modèle inconnu reste indiqué comme tel au lieu d’être présenté comme gratuit.

Consultez l’ordre d’autorisation pour connaître la hiérarchie exacte des politiques et la configuration pour les paramètres locaux.

Documentation

• Fournisseurs et modèles locaux
• Équipes d’agents
• MCP, hooks et configuration
• Client web local
• Toute la documentation
• Organisation du dépôt et guide de contribution

Rejoindre la communauté

Les signalements de bugs, les idées de fonctionnalités et les pull requests sont les bienvenus, que vous utilisiez Codewhale depuis des mois ou que vous l’essayiez pour la première fois. S’il manque un fournisseur, si un workflow est peu pratique ou si l’interface du terminal vous gêne, ouvrez une issue ou envoyez une pull request pour que nous puissions l’améliorer ensemble. Les premières contributions sont les bienvenues, et les personnes qui contribuent restent créditées pour le travail intégré.

Rejoignez le Discord, ou ajoutez Hunter sur WeChat (hunterbown) et demandez à rejoindre le groupe Whale Brothers.

Historique du projet

Codewhale a commencé sous le nom de deepseek-tui et conserve la compatibilité avec sa configuration et ses sessions. Il est désormais indépendant de tout fournisseur, maintenu de manière autonome et n’est affilié à aucun fournisseur de modèles.

Merci à toutes les personnes qui contribuent et aux communautés open source qui ont aidé le projet à grandir. Consultez le registre des contributeurs.

Licence

MIT. Les parties adaptées d’autres projets open source sont répertoriées dans les mentions relatives aux logiciels tiers.