5.2 KiB
Codewhale
Codewhale es un agente de programación de código abierto para tu terminal, desarrollado en Rust y mejorado públicamente junto con las personas que lo usan.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català
Instalación
npm install -g codewhale
codewhale
La primera vez que se ejecuta, Codewhale te ayuda a conectar un proveedor o a seguir sin conexión. También admite Cargo, Docker, Nix, Scoop, archivos precompilados, Android/Termux y un espejo de CNB. Consulta la guía de instalación.
El completado con Tab se configura con un comando por shell — codewhale completion bash|zsh|fish|powershell|elvish. Consulta el completado de shell.
Uso
Habla con Codewhale como hablarías con alguien de tu equipo:
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. Tú decides cuánto acceso darle.
Por qué Codewhale
- Usa el modelo que prefieras. Conecta proveedores alojados o modelos locales mediante Ollama, vLLM o SGLang. Cambia de proveedor y modelo con
/model. - Mantén el control. Plan es de solo lectura. Ask, Auto-Review y Full Access hacen visible el comportamiento de las aprobaciones.
/undorevierte el último turno y/restoredevuelve el espacio de trabajo a una instantánea anterior. - Mantén organizado el trabajo de larga duración. Guarda sesiones, establece un
/goalduradero, 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
Únete a la comunidad
Codewhale mejora cuando las personas lo usan, informan lo que no funciona bien y ayudan a corregirlo. Si falta un proveedor, un flujo de trabajo resulta incómodo o la interfaz de terminal se interpone en tu camino, abre un issue. Si sabes cómo mejorarlo, abre un pull request. 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.