# Instrucciones para el agente: Codewhale: la evolución de DeepSeek TUI para programar en terminal

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/codewhale-hq/Codewhale (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/deepseek-tui

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala la distribución actual

El README redirigido documenta para Unix:

```bash
curl -fsSL https://codewhale.net/install.sh | sh
```

Como alternativa, si ya tienes Node.js y npm disponibles, publica esta opción con npm:

```bash
npm install -g codewhale
```

Elige una vía. El instalador Unix deja `codewhale` y el alias `codew` en `~/.local/bin`; si no se resuelven, aplica la línea de PATH que imprime. Dentro de `codewhale`, ejecuta `/provider` (o F3), selecciona proveedor, introduce su clave y elige un modelo. La alternativa local requiere un modelo de chat ya servido por Ollama.

### Paso 2: prueba una tarea de lectura

Desde la carpeta de un proyecto de prueba, inicia `codewhale` y pide un mapa de sus carpetas antes de solicitar cambios.

## Comprobación

Comprueba el proveedor elegido y revisa `/receipts` tras una tarea. Contrasta las acciones registradas con el resultado real del repositorio.

## Si algo falla

Si una guía menciona paquetes históricos, sigue el repositorio al que GitHub redirige. Si falla el modelo, verifica su acceso por separado antes de cambiar la instalación.