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).
Esta versión vuelve a sincronizar Ghosty con CodeWhale, el proyecto del que nace. Es un salto grande por dentro —el árbol se triplica— pero lo que verás tú es esto:
- Un solo binario.
ghostylo hace todo; ya no existeghosty-tuini el errorCompanion ghosty-tui binary not found. Quien lo tenga instalado recibe el comando viejo refrescado, sin código obsoleto.- Agente completo desde Zed y JetBrains (
ghosty serve --acp): lee y edita archivos, ejecuta comandos, cancela a media respuesta, cambia de modelo. Antes por ACP solo había chat.- Cambia de proveedor sin reiniciar, con el
/providernuevo: lista, prueba la conexión y edita la key desde la TUI.- La constitución se cumple. Las invariantes de
.ghosty/constitution.jsondejan de ser prosa en el prompt y pasan a verificarse mecánicamente.- Límites reales por modelo.
max_tokensy ventana de contexto ya salen del catálogo de cada ruta, no de un número fijo.- EasyBits es proveedor de primera clase (
--provider easybits), no un alias: el modo ya no se pierde al guardar. Yghosty auth setsobre una instalación nueva deja ese proveedor activo, sin paso extra.- El fantasma volvió, con más gestos.
Sigue disponible Kimi K3 con tu key de Moonshot (1M de contexto):
ghosty auth set --provider moonshot --api-key "TU_KEY_MOONSHOT"
Recomendado — sin Node ni Rust, baja el binario precompilado:
curl -fsSL https://formmy.app/ghosty/install.sh | sh# 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/releasesEl paquete de npm se llama ghostycode; el comando que instala es ghosty.
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 interactivaLa 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.
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- 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.
| 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 <nombre> o /model dentro de la TUI.
Ghosty habla con la familia GLM de Z.AI por dos rutas:
Directo (Z.AI Coding Plan) — provider = "zai" (ZAI_API_KEY), endpoint
api.z.ai/api/coding/paas/v4. Paridad de cache y thinking con DeepSeek:
| Modelo | Contexto | Ideal para |
|---|---|---|
GLM-5.2 (default) |
— | Modelo GLM más capaz |
GLM-5.1 |
— | GLM estándar |
GLM-5-Turbo |
— | GLM rápido para explorar |
Vía OpenRouter — provider = "openrouter" (OPENROUTER_API_KEY):
z-ai/glm-5.2 (1M), z-ai/glm-5.1 (202K), z-ai/glm-5-turbo (202K).
La lista completa de modelos OpenRouter (Qwen, Kimi, MiniMax, Gemma, etc.) está
en docs/PROVIDERS.md.
Ghosty trae preconfigurado el servidor MCP de easybits (gestión de archivos desde el agente, 100+ herramientas). Viene desactivado de fábrica hasta que añadas tu llave, así que una instalación nueva nunca falla por falta de credencial.
-
Consigue tu API key en el panel de desarrollador de easybits: https://www.easybits.cloud/dash/developer
-
Añádela (esto la activa):
ghosty mcp add easybits --url "https://www.easybits.cloud/api/mcp?tools=core" --bearer TU_EASYBITS_API_KEY -
Verifica:
ghosty mcp list
¿Por qué un solo grupo y no
core,sandbox? EasyBits revende DeepSeek, cuya API tiene un tope duro de 128 tools por request y las cuenta todas.coreson 65 ysandbox47; con las ~36 built-in de Ghosty, uno solo cabe y los dos juntos no (146 > 128 →Invalid 'tools': array too long). Ghosty te avisa antes de enviar la petición si te pasas.Para tener cajas, S3 y base de datos a la vez, usa el modo híbrido: conecta solo
?tools=sandboxpor MCP (crear una caja no tiene endpoint REST) y usa S3 y DB porcurlcontrahttps://www.easybits.cloud/api/v2con la misma key. Está paso a paso endocs/TALLER.md.
Gestiona otros servidores con ghosty mcp add stdio|http <nombre> ...,
ghosty mcp enable|disable|remove <nombre> y ghosty mcp validate.
- Servidor:
ghosty serve --http(API HTTP/SSE) o--mobile(control desde el móvil en LAN). - Zed/ACP:
ghosty serve --acp. - Otros proveedores compatibles con OpenAI vía
base_urlen la config.
- formmy.app/ghosty — Ghosty on the web: run your agent from a browser dashboard.
- easybits.cloud — File management MCP server (100+ tools), pre-bundled with Ghosty.
MIT — ver LICENSE.