Codewhale

Codewhale es un agente de código abierto que lee tu proyecto, edita archivos, ejecuta comandos y comprueba su trabajo con un modelo alojado o local que tú eliges. Empieza con una tarea en la terminal. Para un trabajo más grande, asigna partes del trabajo a agentes con distintos modelos y roles.

Vista previa de la terminal de una compilación de desarrollo de v0.9.12.

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

Instalación

Para una instalación nueva en macOS o Linux, usa la versión oficial de GitHub:

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

El instalador selecciona la última versión publicada. El registro de cambios también describe la versión candidata aún no publicada de la próxima versión; esos cambios no se incluyen en las descargas publicadas hasta que la versión esté disponible.

En Windows, descarga el instalador o archivo correspondiente de GitHub Releases. Para actualizar una instalación directa existente, ejecuta codewhale update, o codewhale update --check para consultar sin instalar. El actualizador muestra la ruta del ejecutable y conserva las compilaciones más recientes. npm y Cargo son opciones secundarias; consulta la guía de instalación para migrar desde un gestor de paquetes y configurar PATH.

La primera vez que se ejecuta, Codewhale te ayuda a conectar un proveedor o a configurar Codewhale sin conexión. Las respuestas requieren un modelo alojado o local conectado. Codewhale también admite npm y Cargo como opciones secundarias de distribución, además de Docker, Nix, Scoop, Android/Termux y un espejo opcional de CNB. Las instalaciones existentes gestionadas por paquetes reciben instrucciones de migración. Consulta la ayuda de instalación y PATH.

El completado con Tab se configura con un comando por shell — codewhale completion bash|zsh|fish|powershell|elvish. Consulta el completado de shell.

Uso

Abre una terminal en la carpeta de tu proyecto y ejecuta codewhale. Elige tu proveedor con /provider y tu modelo con /model. Después, describe una tarea concreta:

Fix the failing tests and explain what changed.

También puedes ejecutar una tarea sin abrir la TUI:

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

Codewhale puede leer tu repositorio, editar archivos, ejecutar comandos, revisar los resultados y seguir trabajando para alcanzar un objetivo. Usa /mode plan para explorar sin modificar archivos ni ejecutar comandos de shell, y /mode work cuando quieras que haga cambios. Presiona Shift+Tab para elegir Ask, Auto-Review o Full Access; la guía de modos y permisos explica qué permite cada opción.

Terminal, aplicaciones y Computer Use

La terminal y los clientes gráficos se conectan al Runtime de Codewhale, que ejecuta el agente y sus herramientas:

• Terminal: codewhale abre la interfaz interactiva; codewhale exec ejecuta una tarea desde un script o un trabajo de CI.
• Navegador local: codewhale web abre el cliente web local incluido, que usa el mismo runtime.
• Aplicaciones web y de escritorio de Codewhale: entornos de trabajo gráficos en desarrollo. Su disponibilidad se indica en la página del producto.

Computer Use agrega herramientas para observar otras aplicaciones e interactuar con ellas. El plugin está incluido en el código fuente actual. Revisa el acceso que solicita y habilítalo antes de usarlo; los permisos del sistema operativo y los requisitos de la plataforma siguen siendo necesarios. Consulta la guía de Computer Use incluida y la configuración de plugins.

Para VS Code, la extensión CodeWhale mantenida por la comunidad se conecta al Runtime local desde una barra lateral. Instálala desde el VS Code Marketplace; el código fuente está en GitHub.

Por qué Codewhale

• Elige tus modelos. Conecta proveedores alojados o modelos locales mediante Ollama, vLLM o SGLang. Usa /provider para cambiar de proveedor y /model para elegir un modelo.
• Mantén el control. Revisa las acciones propuestas y los cambios que producen en los archivos. La configuración de aprobaciones determina cuándo se necesita una revisión; Full Access sigue respetando los límites obligatorios de las políticas. /undo y /restore ayudan a recuperar cambios del espacio de trabajo.
• Mantén organizado el trabajo de larga duración. Guarda sesiones, establece un /goal duradero, revisa los flujos de trabajo antes de ejecutarlos y coordina agentes sin convertir sus instrucciones internas en parte de tu conversación.
• Amplía el agente que ya tienes. Conecta servidores MCP y habilidades, configura hooks y conserva los roles de los agentes como archivos legibles en tu proyecto o configuración personal.

Ejecuta /help en la TUI para ver los comandos y atajos de teclado.

Seguridad

Codewhale se ejecuta en tu equipo con el acceso que le otorgues. Los modos de aprobación y las reglas del repositorio limitan lo que el agente puede hacer; el aislamiento opcional del sistema operativo añade un límite de ejecución más sólido cuando es compatible. Los precios desconocidos de los modelos permanecen como desconocidos en lugar de mostrarse como gratuitos.

Lee el orden de autorización para conocer la jerarquía exacta de políticas y la configuración para los ajustes locales.

Documentación

• Proveedores y modelos locales
• Equipos de agentes
• MCP, hooks y configuración
• Cliente web local
• Toda la documentación
• Estructura del repositorio y guía de contribución

Únete a la comunidad

Recibimos con gusto reportes de errores, ideas de funciones y pull requests, tanto si llevas meses usando Codewhale como si lo pruebas por primera vez. Si falta un proveedor, un flujo de trabajo resulta incómodo o la interfaz de terminal te estorba, abre un issue o envía un pull request para que podamos mejorarlo juntos. Las primeras contribuciones son bienvenidas y quienes contribuyen conservan el crédito por el trabajo que se incorpora.

Únete a Discord, o agrega a Hunter en WeChat (hunterbown) y pide entrar al grupo Whale Brothers.

Historia del proyecto

Codewhale comenzó como deepseek-tui y aún conserva la compatibilidad con su configuración y sus sesiones. Ahora es neutral respecto de los proveedores, se mantiene de forma independiente y no está afiliado a ningún proveedor de modelos.

Gracias a cada colaborador y a las comunidades de código abierto que ayudaron a crecer al proyecto. Consulta el registro de colaboradores.

Licencia

MIT. Las partes adaptadas de otros proyectos de código abierto se registran en los avisos de terceros.