| 1 | <!-- source: README.md sha256:a87c9f323f35 --> |
| 2 | # Codewhale |
| 3 | |
| 4 | Un agente de programación de código abierto para tu terminal — trae tu propio modelo. |
| 5 | |
| 6 | Codewhale empezó como una experiencia nativa para DeepSeek. Desde entonces se ha |
| 7 | convertido en un proyecto impulsado por la comunidad: un harness de programación |
| 8 | que se adapta a una comunidad internacional en crecimiento y admite tantos |
| 9 | modelos y proveedores como sea posible — los modelos abiertos primero, alojados |
| 10 | o locales, sin privilegiar a ninguno. |
| 11 | |
| 12 | Le das un proveedor, un modelo y una tarea. Lee tu código, edita archivos, |
| 13 | ejecuta comandos y verifica su propio trabajo, y se detiene cuando la tarea |
| 14 | queda lista o te necesita. Cambia de modelo a mitad de tarea con `/model`. |
| 15 | Trabaja de forma interactiva en la TUI, o ejecuta `codewhale exec` en scripts y |
| 16 | CI. Está escrito en Rust, con licencia MIT, y corre en tu máquina. |
| 17 | |
| 18 | Siempre estamos buscando personas que contribuyan y formas de mejorar. Si falta |
| 19 | un modelo o proveedor que usas, o algo se rompe, contárnoslo es una de las cosas |
| 20 | más útiles que puedes hacer — mira [Contribuir](#contribuir). |
| 21 | |
| 22 | [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) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug) |
| 23 | |
| 24 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 25 | [](https://crates.io/crates/codewhale-cli) |
| 26 | [](https://www.npmjs.com/package/codewhale) |
| 27 | [](https://discord.gg/37gfS3ksug) |
| 28 | |
| 29 |  |
| 30 | |
| 31 | ## Instalación |
| 32 | |
| 33 | ```bash |
| 34 | npm install -g codewhale |
| 35 | ``` |
| 36 | |
| 37 | Cargo, Docker, Nix, Scoop, archivos precompilados, Android/Termux y un espejo |
| 38 | en CNB para quienes no pueden acceder a GitHub están cubiertos en |
| 39 | [docs/INSTALL.md](docs/INSTALL.md). ¿Vienes de `deepseek-tui`? Tu configuración |
| 40 | y tus sesiones se conservan — mira [docs/REBRAND.md](docs/REBRAND.md). |
| 41 | |
| 42 | ## Uso |
| 43 | |
| 44 | ```bash |
| 45 | codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc. |
| 46 | codewhale # open the TUI |
| 47 | codewhale exec "fix the failing test" # headless |
| 48 | codewhale web # local browser client on 127.0.0.1 |
| 49 | ``` |
| 50 | |
| 51 | |
| 52 | En la TUI: `/model` cambia proveedor y modelo juntos, `/fleet` ejecuta un |
| 53 | equipo de workers, `/undo` deshace el último turno y `/restore <N>` revierte el |
| 54 | workspace a una instantánea anterior (`/restore` sin argumentos solo las |
| 55 | lista). Cuando el compositor está vacío, `Tab` cicla entre Plan / Act / |
| 56 | Operate; con texto escrito, `Tab` completa comandos slash y menciones `@`. |
| 57 | `Shift+Tab` cicla la postura de permiso Ask / Auto-Review / Full Access en |
| 58 | cualquier momento. `!` ejecuta un comando de shell por la ruta normal de |
| 59 | aprobación. |
| 60 | |
| 61 | ## Qué hace |
| 62 | |
| 63 | - **Cualquier modelo, cualquier proveedor.** DeepSeek, Claude, GPT, Kimi, GLM y |
| 64 | más de 30 proveedores, además de tu propio vLLM, SGLang u Ollama sin key — |
| 65 | todo a través de un solo runtime y un solo conjunto de herramientas. Los |
| 66 | presupuestos de contexto y los precios vienen de la ruta real, y un precio |
| 67 | desconocido se muestra como desconocido en lugar de $0. |
| 68 | - **Solo lectura hasta que permitas más.** El modo Plan no cambia archivos, y |
| 69 | las aprobaciones controlan los comandos riesgosos. Cuando un sandbox del |
| 70 | sistema operativo realmente envuelve un comando, Codewhale lo indica: Seatbelt |
| 71 | en macOS cuando está disponible, bubblewrap opcional en Linux. El |
| 72 | `constitution.json` de un repo se compila en bloqueos de escritura que ni |
| 73 | siquiera Full Access puede saltarse. |
| 74 | - **Trabajo que puedes retomar.** Un fleet registra cada paso en un libro mayor |
| 75 | de solo agregado, así que `fleet resume` retoma donde te detuviste. |
| 76 | |
| 77 | ## Para saber más |
| 78 | |
| 79 | - [docs/PROVIDERS.md](docs/PROVIDERS.md) — cada ruta de proveedor: alojada, |
| 80 | gateway y local |
| 81 | - [docs/FLEET.md](docs/FLEET.md) — fleets, el libro mayor y resume |
| 82 | - [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — |
| 83 | búsqueda experimental congelada y neutral respecto al proveedor dentro de |
| 84 | Workflow |
| 85 | - [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, hooks y la |
| 86 | constitution |
| 87 | - [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — cómo se combinan |
| 88 | los modos, hooks, reglas de permisos, límites mínimos de seguridad, reglas del |
| 89 | repositorio, aprobaciones y sandboxing |
| 90 | - [docs/HOOKS.md](docs/HOOKS.md) — los once eventos de hooks del ciclo de vida |
| 91 | de la TUI, sus payloads y los tres que pueden dirigir un turno (`codewhale |
| 92 | exec` y los subcomandos de la CLI no activan hooks) |
| 93 | - [docs/WEB.md](docs/WEB.md) — cliente de navegador integrado solo en loopback |
| 94 | y su límite de autenticación de un solo uso |
| 95 | |
| 96 | Todo lo demás — modos, atajos de teclado, detalles del sandbox, MCP, la API |
| 97 | del runtime, arquitectura — está en [docs](docs) y en |
| 98 | [codewhale.net](https://codewhale.net/). |
| 99 | |
| 100 | ## Contribuir |
| 101 | |
| 102 | Issues, PRs, pasos de reproducción, logs y solicitudes de features son trabajo |
| 103 | real del proyecto, y las primeras contribuciones son bienvenidas. Cuando un PR |
| 104 | no se puede fusionar tal cual, los mantenedores rescatan lo que funciona y el |
| 105 | autor conserva su crédito — en el commit, en el changelog y en |
| 106 | [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md). |
| 107 | |
| 108 | - [Issues abiertos](https://github.com/Hmbown/CodeWhale/issues) — las buenas |
| 109 | primeras contribuciones viven aquí |
| 110 | - [CONTRIBUTING.md](CONTRIBUTING.md) — setup de desarrollo y flujo de PRs |
| 111 | - [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — todas las personas que le han |
| 112 | dado forma a esto |
| 113 | - [Invítame un café](https://www.buymeacoffee.com/hmbown) |
| 114 | |
| 115 | Gracias a [DeepSeek](https://github.com/deepseek-ai) por los modelos y el apoyo |
| 116 | que dieron inicio al proyecto, a [DataWhale](https://github.com/datawhalechina) |
| 117 | 🐋 por recibirnos en la familia Whale Brother, y a |
| 118 | [OpenWarp](https://github.com/zerx-lab/warp) y |
| 119 | [Open Design](https://github.com/nexu-io/open-design) por colaborar en la |
| 120 | experiencia de agente en terminal. |
| 121 | |
| 122 | ## Licencia |
| 123 | |
| 124 | [MIT](LICENSE). Proyecto comunitario independiente; sin afiliación con ningún |
| 125 | proveedor de modelos. |
| 126 | |
| 127 | [](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date) |
| 128 |