
# Ghosty Code
**DeepSeek V4 terminal coding agent & constitutional harness.** đź‘»
[](https://github.com/blissito/ghostycode/actions/workflows/ci.yml)
Ghosty Code is a **DeepSeek V4 terminal coding agent** and **constitutional harness** —
a Rust TUI that reads, edits, runs shell commands, searches your repo, and coordinates
sub-agents through long tool-using sessions with evidence-driven verification.
Built for developers who want a keyboard-first coding agent with MCP support,
session persistence, and zero vendor lock-in. Open source (MIT).
> ### ⚡ Novedad (0.0.19) — ACP ya viaja por red
>
> Hasta ahora el agente sĂłlo hablaba ACP por stdio, o sea que el cliente tenĂa que
> lanzar a Ghosty como proceso hijo: un navegador no puede, y una caja remota
> tampoco. `ghosty serve`, sin banderas, lo publica en `ws://host:port/acp`
> —WebSocket y Streamable HTTP, la RFD oficial— y atiende a varios clientes a la
> vez, cada uno con sus propias sesiones. El transporte es el del SDK oficial de
> ACP, no uno escrito a mano.
>
> Como esa vĂa ejecuta herramientas, exige token de runtime y polĂtica de origen:
> sin `Origin` sólo entra quien manda cabecera `Authorization`, que una página del
> navegador no puede fijar.
>
> Lo anterior, en el [CHANGELOG](CHANGELOG.md).
## InstalaciĂłn
**Recomendado** — sin Node ni Rust, baja el binario precompilado:
```bash
curl -fsSL https://formmy.app/ghosty/install.sh | sh
```
### Alternativas
```bash
# npm (baja el binario precompilado del release)
npm install -g ghostycode
# Cargo (requiere Rust 1.88+)
cargo install --git https://github.com/blissito/ghostycode ghosty-cli
# Descarga directa: archivos por plataforma en
# https://github.com/blissito/ghostycode/releases
```
El paquete de npm se llama **`ghostycode`**; el comando que instala es **`ghosty`**.
## Primer uso
```bash
ghosty auth set --provider deepseek --api-key "TU_DEEPSEEK_API_KEY"
# Kimi K3 directo (Moonshot; 1M contexto)
ghosty auth set --provider moonshot --api-key "TU_KEY_MOONSHOT"
# GLM-5.2 directo (Z.AI Coding Plan)
ghosty auth set --provider zai --api-key "TU_TOKEN_ZAI"
# EasyBits (revendedor de DeepSeek; la misma key sirve para LLM y MCP)
ghosty auth set --provider easybits --api-key "TU_EASYBITS_API_KEY"
ghosty doctor # verifica setup y conexiĂłn
ghosty # abre la TUI interactiva
```
La config vive en `~/.ghosty/config.toml`. También puedes usar la variable de entorno
`DEEPSEEK_API_KEY`. Más providers y las notas de EasyBits en
[`docs/PROVIDERS.md`](docs/PROVIDERS.md).
## Comandos básicos
```bash
ghosty # TUI interactiva
ghosty "explica esta funciĂłn" # prompt de una sola vez
ghosty --model auto "arregla el bug" # auto-selecciona modelo + thinking
ghosty --yolo # auto-aprueba herramientas
ghosty sessions # lista sesiones guardadas
ghosty resume --last # retoma la Ăşltima sesiĂłn
ghosty models # lista modelos disponibles
ghosty update # actualiza el binario
```
## Modos
- **Agent** — ejecuta herramientas (editar, correr, buscar) con tu aprobación.
- **Plan** — propone un plan antes de tocar nada.
- **Yolo** (`--yolo`) — auto-aprueba todo. Úsalo con cuidado.
Cambia de modo dentro de la TUI o con flags al arrancar.
## Modelos DeepSeek V4
| Modelo | Thinking | Ideal para |
|--------|----------|------------|
| `deepseek-v4-pro` | âś… | Razonamiento complejo, cĂłdigo, mates |
| `deepseek-v4-flash` | ❌ | Tareas rápidas y económicas |
| `auto` | — | Elige modelo + thinking según el turno |
Override con `--model