Ghosty Code

DeepSeek V4 terminal coding agent & constitutional harness. 👻

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).

Instalación

Recomendado — sin Node ni Rust, baja el binario precompilado:

curl -fsSL https://formmy.app/ghosty/install.sh | sh

Alternativas

# npm (baja los binarios precompilados 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

ghosty auth set --provider deepseek --api-key "TU_DEEPSEEK_API_KEY"
# Alternativa: 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.

Comandos básicos

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 <nombre> o /model dentro de la TUI.

MCP — easybits incluido por defecto

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=all" --bearer TU_EASYBITS_API_KEY

Verifica: ghosty mcp list

Gestiona otros servidores con ghosty mcp add stdio|http <nombre> ...,
ghosty mcp enable|disable|remove <nombre> y ghosty mcp validate.

Más

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_url en 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.

Licencia

MIT — ver LICENSE.

ghostycode