Sobre el proyecto

Codewhale es un agente de codificación de terminal de código abierto. Escrito en Rust, lee un proyecto, edita archivos, ejecuta comandos y comprueba su propio trabajo usando un modelo alojado o local elegido por el usuario. El proyecto comenzó como `deepseek-tui` y mantiene la compatibilidad de configuración y sesión, pero ahora es neutral en cuanto a proveedores y se mantiene de forma independiente, sin afiliación con ningún proveedor de modelos. La instalación en macOS y Linux se realiza mediante un script oficial que selecciona la última versión publicada; los usuarios de Windows descargan un instalador o archivo desde GitHub Releases. Un comando de actualización comprueba y aplica nuevas construcciones. Se admiten npm y Cargo como rutas secundarias de empaquetado, junto con Docker, Nix, Scoop, Android/Termux y un espejo CNB opcional. Las finalizaciones de shell se generan por shell. El uso se centra en ejecutar `codewhale` dentro de una carpeta de proyecto, seleccionar un proveedor con `/provider` y un modelo con `/model`, luego describir una tarea concreta. Las tareas también se pueden ejecutar de forma no interactiva con `codewhale exec`, lo que es adecuado para scripts y trabajos de CI. El agente puede leer repositorios, editar archivos, ejecutar comandos, inspeccionar resultados y seguir trabajando hacia un objetivo. Un modo de plan permite explorar sin cambiar archivos o ejecutar shells, mientras que un modo de trabajo permite cambios; los atajos de teclado cambian entre niveles de permiso Ask, Auto-Review y Full Access. Además de la interfaz de terminal, un cliente web local integrado se conecta al mismo Codewhale Runtime, y se describen entornos de trabajo gráficos web y de escritorio en desarrollo. Una extensión de VS Code mantenida por la comunidad se conecta al Runtime local desde una barra lateral. Un complemento de Uso de Computadora, incluido en el código fuente, agrega herramientas para observar e interactuar con otras aplicaciones, sujeto a permisos del sistema operativo y requisitos de plataforma. Capacidades notables incluyen conectarse a proveedores alojados o modelos locales a través de Ollama, vLLM o SGLang; inspeccionar acciones propuestas y cambios en archivos resultantes; configuraciones de aprobación con límites de política rígidos incluso bajo Full Access; deshacer y restaurar cambios en el espacio de trabajo; sesiones guardadas, objetivos duraderos, revisión de flujos de trabajo antes de la ejecución y coordinación de agentes con modelos y roles diferentes; y extensión mediante servidores MCP, habilidades, ganchos y archivos de rol de agente legibles. Los precios de modelos desconocidos se informan como desconocidos en lugar de gratuitos. La documentación cubre proveedores y modelos locales, equipos de agentes, MCP, ganchos, configuración, cliente web local, orden de autorización, modos y permisos, instalación y estructura del repositorio. El proyecto está licenciado bajo MIT, con notas de terceros registradas, y acepta informes de errores, ideas de características y solicitudes de extracción.