| 1 | <!-- source: README.md sha256:ebf1c69de0dc --> |
| 2 | # Codewhale |
| 3 | |
| 4 | 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. |
| 5 | |
| 6 |  |
| 7 | |
| 8 | *Vista previa de la terminal de una compilación de desarrollo de v0.9.12.* |
| 9 | |
| 10 | [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) |
| 11 | |
| 12 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 13 | [](https://crates.io/crates/codewhale-cli) |
| 14 | [](https://www.npmjs.com/package/codewhale) |
| 15 | [](https://discord.gg/37gfS3ksug) |
| 16 | |
| 17 | ## Instalación |
| 18 | |
| 19 | Para una instalación nueva en macOS o Linux, usa la versión oficial de GitHub: |
| 20 | |
| 21 | ```bash |
| 22 | curl -fsSL https://codewhale.net/install.sh | sh |
| 23 | "$HOME/.local/bin/codewhale" |
| 24 | ``` |
| 25 | |
| 26 | El instalador selecciona la última versión publicada. El [registro de cambios](CHANGELOG.md) 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. |
| 27 | |
| 28 | En Windows, descarga el instalador o archivo correspondiente de [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases/latest). 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](docs/INSTALL.md) para migrar desde un gestor de paquetes y configurar PATH. |
| 29 | |
| 30 | 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](docs/INSTALL.md). |
| 31 | |
| 32 | El completado con Tab se configura con un comando por shell — `codewhale completion bash|zsh|fish|powershell|elvish`. Consulta el [completado de shell](docs/INSTALL.md#8-shell-completions). |
| 33 | |
| 34 | ## Uso |
| 35 | |
| 36 | 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: |
| 37 | |
| 38 | ```text |
| 39 | Fix the failing tests and explain what changed. |
| 40 | ``` |
| 41 | |
| 42 | También puedes ejecutar una tarea sin abrir la TUI: |
| 43 | |
| 44 | ```bash |
| 45 | codewhale exec "fix the failing tests and explain what changed" |
| 46 | ``` |
| 47 | |
| 48 | 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](docs/MODES.md) explica qué permite cada opción. |
| 49 | |
| 50 | ## Terminal, aplicaciones y Computer Use |
| 51 | |
| 52 | La terminal y los clientes gráficos se conectan al Runtime de Codewhale, que ejecuta el agente y sus herramientas: |
| 53 | |
| 54 | - **Terminal:** `codewhale` abre la interfaz interactiva; `codewhale exec` ejecuta una tarea desde un script o un trabajo de CI. |
| 55 | - **Navegador local:** `codewhale web` abre el [cliente web local](docs/WEB.md) incluido, que usa el mismo runtime. |
| 56 | - **Aplicación de escritorio Codewhale (GPUI):** la aplicación de escritorio nativa GPUI es la dirección del cliente de producto (decisión del 2026-09-14; el mapa de fases está en docs/TRANSITION.md del repositorio privado codehwhale-gpui). La aplicación web alojada en app.codewhale.net se retira por fases; el sitio de marketing, el inicio de sesión, la facturación y las páginas legales y de descarga permanecen en la web de forma permanente. Su disponibilidad se indica en la [página del producto](https://codewhale.net/en/product). |
| 57 | |
| 58 | **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](crates/tui/plugins/computer-use/README.md) incluida y la [configuración de plugins](docs/PLUGINS.md). |
| 59 | |
| 60 | 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](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode); el código fuente está en [GitHub](https://github.com/HengQuWorld/CodeWhale-VSCode). |
| 61 | |
| 62 | ## Por qué Codewhale |
| 63 | |
| 64 | - **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. |
| 65 | - **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. |
| 66 | - **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. |
| 67 | - **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. |
| 68 | |
| 69 | Ejecuta `/help` en la TUI para ver los comandos y atajos de teclado. |
| 70 | |
| 71 | ## Seguridad |
| 72 | |
| 73 | 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. |
| 74 | |
| 75 | Lee el [orden de autorización](docs/AUTHORIZATION_ORDER.md) para conocer la jerarquía exacta de políticas y la [configuración](docs/CONFIGURATION.md) para los ajustes locales. |
| 76 | |
| 77 | ## Documentación |
| 78 | |
| 79 | - [Proveedores y modelos locales](docs/PROVIDERS.md) |
| 80 | - [Equipos de agentes](docs/FLEET.md) |
| 81 | - [MCP](docs/MCP.md), [hooks](docs/HOOKS.md) y [configuración](docs/CONFIGURATION.md) |
| 82 | - [Cliente web local](docs/WEB.md) |
| 83 | - [Toda la documentación](docs) |
| 84 | - [Estructura del repositorio y guía de contribución](CONTRIBUTING.md#project-structure) |
| 85 | |
| 86 | ## Únete a la comunidad |
| 87 | |
| 88 | **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](https://github.com/Hmbown/CodeWhale/issues/new/choose) o [envía un pull request](CONTRIBUTING.md) para que podamos mejorarlo juntos. Las primeras contribuciones son bienvenidas y quienes contribuyen conservan el crédito por el trabajo que se incorpora. |
| 89 | |
| 90 | Únete a [Discord](https://discord.gg/37gfS3ksug), o agrega a Hunter en WeChat (`hunterbown`) y pide entrar al grupo Whale Brothers. |
| 91 | |
| 92 | ## Historia del proyecto |
| 93 | |
| 94 | 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. |
| 95 | |
| 96 | Gracias a cada colaborador y a las comunidades de código abierto que ayudaron a crecer al proyecto. Consulta el [registro de colaboradores](docs/CONTRIBUTORS.md). |
| 97 | |
| 98 | ## Licencia |
| 99 | |
| 100 | [MIT](LICENSE). Las partes adaptadas de otros proyectos de código abierto se registran en los [avisos de terceros](docs/THIRD_PARTY_NOTICES.md). |
| 101 |