hmbown--codewhale/README.es-419.md

Codewhale

Un agente de programación de código abierto para tu terminal — trae tu propio modelo.

Codewhale empezó como una experiencia nativa para DeepSeek. Desde entonces se ha convertido en un proyecto impulsado por la comunidad: un harness de programación que se adapta a una comunidad internacional en crecimiento y admite tantos modelos y proveedores como sea posible — los modelos abiertos primero, alojados o locales, sin privilegiar a ninguno.

Le das un proveedor, un modelo y una tarea. Lee tu código, edita archivos, ejecuta comandos y verifica su propio trabajo, y se detiene cuando la tarea queda lista o te necesita. Cambia de modelo a mitad de tarea con /model. Trabaja de forma interactiva en la TUI, o ejecuta codewhale exec en scripts y CI. Está escrito en Rust, con licencia MIT, y corre en tu máquina.

Lo que no se parece a otros harnesses: tú eliges el modelo de cada rol, y no tienen por qué coincidir. Una fleet fija un proveedor, un modelo y un nivel de razonamiento por rol — así un modelo barato y rápido puede dirigir a uno de razonamiento caro, o un builder GLM puede trabajar en la misma tarea que un reviewer Kimi. Escribe tus propios roles y tu propia constitution, y el harness es tuyo en lugar de nuestro.

Siempre estamos buscando personas que contribuyan y formas de mejorar. Si falta un modelo o proveedor que usas, o algo se rompe, contárnoslo es una de las cosas más útiles que puedes hacer — mira Contribuir.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Português · Русский · Українська · codewhale.net · Docs · Changelog · Discord

Instalación

npm install -g codewhale

Cargo, Docker, Nix, Scoop, archivos precompilados, Android/Termux y un espejo en CNB para quienes no pueden acceder a GitHub están cubiertos en docs/INSTALL.md. ¿Vienes de deepseek-tui? Tu configuración y tus sesiones se conservan — mira docs/REBRAND.md.

Uso

codewhale auth set --provider deepseek   # or export ANTHROPIC_API_KEY, etc.
codewhale                                # open the TUI
codewhale exec "fix the failing test"    # headless
codewhale web                            # local browser client on 127.0.0.1

En la TUI: /model cambia proveedor y modelo juntos, /fleet ejecuta un equipo de workers, /undo deshace el último turno y /restore <N> revierte el workspace a una instantánea anterior (/restore sin argumentos solo las lista). Cuando el compositor está vacío, Tab cicla entre Plan / Work / Operate; con texto escrito, Tab completa comandos slash y menciones @. Shift+Tab cicla la postura de permiso Ask / Auto-Review / Full Access en cualquier momento. ! ejecuta un comando de shell por la ruta normal de aprobación.

Qué hace

• Cualquier modelo, cualquier proveedor. DeepSeek, Claude, GPT, Kimi, GLM y más de 30 proveedores, además de tu propio vLLM, SGLang u Ollama sin key — todo a través de un solo runtime y un solo conjunto de herramientas. Los presupuestos de contexto y los precios vienen de la ruta real, y un precio desconocido se muestra como desconocido en lugar de $0.
• Un harness que tú escribes. Los roles son archivos que puedes leer y editar — un modelo, una postura de herramientas e instrucciones permanentes por rol — guardados en el proyecto para que el equipo los comparta, o junto a tus ajustes personales para que te acompañen entre repos. Una constitution registra cómo quieres que el agente se comporte en cada sesión, de modo que el harness se ajuste a tu práctica y no a la nuestra.
• Solo lectura hasta que permitas más. El modo Plan no cambia archivos, y las aprobaciones controlan los comandos riesgosos. Cuando un sandbox del sistema operativo realmente envuelve un comando, Codewhale lo indica: Seatbelt en macOS cuando está disponible, bubblewrap opcional en Linux. El constitution.json de un repo se compila en bloqueos de escritura que ni siquiera Full Access puede saltarse.
• Trabajo que puedes retomar. Un fleet registra cada paso en un libro mayor de solo agregado, así que fleet resume retoma donde te detuviste.

Para saber más

• docs/PROVIDERS.md — cada ruta de proveedor: alojada, gateway y local
• docs/FLEET.md — fleets, el libro mayor y resume
• docs/WORKFLOW_EXPERIMENTAL_SEARCH.md — búsqueda experimental congelada y neutral respecto al proveedor dentro de Workflow
• docs/CONFIGURATION.md — config.toml, hooks y la constitution
• docs/AUTHORIZATION_ORDER.md — cómo se combinan los modos, hooks, reglas de permisos, límites mínimos de seguridad, reglas del repositorio, aprobaciones y sandboxing
• docs/HOOKS.md — los once eventos de hooks del ciclo de vida de la TUI, sus payloads y los tres que pueden dirigir un turno (codewhale exec y los subcomandos de la CLI no activan hooks)
• docs/WEB.md — cliente de navegador integrado solo en loopback y su límite de autenticación de un solo uso

Todo lo demás — modos, atajos de teclado, detalles del sandbox, MCP, la API del runtime, arquitectura — está en docs y en codewhale.net.

Contribuir

Issues, PRs, pasos de reproducción, logs y solicitudes de features son trabajo real del proyecto, y las primeras contribuciones son bienvenidas. Cuando un PR no se puede fusionar tal cual, los mantenedores rescatan lo que funciona y el autor conserva su crédito — en el commit, en el changelog y en docs/CONTRIBUTORS.md.

• Issues abiertos — las buenas primeras contribuciones viven aquí
• CONTRIBUTING.md — setup de desarrollo y flujo de PRs
• docs/CONTRIBUTORS.md — todas las personas que le han dado forma a esto
• Invítame un café

Gracias a DeepSeek por los modelos y el apoyo que dieron inicio al proyecto, a DataWhale 🐋 por recibirnos en la familia Whale Brother, y a OpenWarp y Open Design por colaborar en la experiencia de agente en terminal.

Licencia

MIT. Proyecto comunitario independiente; sin afiliación con ningún proveedor de modelos.