DeepSeek-TUI: ejecuta un agente de programación DeepSeek en la terminal

Fri, 08 May 2026 13:41:15 +0800

DeepSeek-TUI es un agente de programación con IA que corre en la terminal. Está diseñado alrededor de modelos DeepSeek V4 y se inicia con el comando deepseek. Dentro de una TUI puede leer y editar archivos, ejecutar comandos shell, buscar en la web, gestionar git, conectar servidores MCP y coordinar subagentes.

Es más un espacio de trabajo de terminal que un chat CLI simple. Combina lectura de código, edición de archivos, comandos, diagnósticos, recuperación de sesión y rollback del workspace.

El repositorio está escrito principalmente en Rust y usa licencia MIT.

Para quién es

Sirve para desarrolladores que prefieren trabajar en terminal y quieren usar modelos DeepSeek en tareas locales reales.

Cambios de código y análisis de proyectos.
Trabajo sin abrir un IDE completo.
Lectura y modificación de un workspace local.
Modos Plan, Agent y YOLO.
Guardar y reanudar sesiones largas.
Revertir cambios del workspace.
Integrar MCP, diagnósticos LSP, HTTP/SSE runtime API y skills.

Para preguntas simples, un cliente web o CLI ligero basta. DeepSeek-TUI tiene más sentido cuando el modelo debe formar parte del flujo de desarrollo local.

Instalación

Con npm:

1
2
3

npm install -g deepseek-tui
deepseek --version
deepseek --model auto

El paquete npm es un instalador/wrapper que descarga binarios Rust precompilados. Requiere Node.js >=18.

Con Cargo:

1
2

cargo install deepseek-tui-cli --locked
cargo install deepseek-tui --locked

Con Homebrew:

1
2

brew tap Hmbown/deepseek-tui
brew install deepseek-tui

También hay binarios en GitHub Releases para Linux x64/ARM64, macOS x64/ARM64 y Windows x64.

Docker:

docker run --rm -it \
  -e DEEPSEEK_API_KEY \
  -v "$PWD:/workspace" \
  ghcr.io/hmbown/deepseek-tui:latest

Configurar la API Key

En el primer inicio, DeepSeek-TUI pide la API key y la guarda en:

`1`	`~/.deepseek/config.toml`

También puedes configurarla así:

1
2

deepseek auth set --provider deepseek
deepseek auth status

O usar variable de entorno:

1
2

export DEEPSEEK_API_KEY="YOUR_KEY"
deepseek

Comprueba la instalación:

`1`	`deepseek doctor`

Para borrar la clave guardada:

`1`	`deepseek auth clear --provider deepseek`

Auto mode

`1`	`deepseek --model auto`

En la TUI:

`1`	`/model auto`

Auto mode decide dos cosas:

Modelo: deepseek-v4-flash o deepseek-v4-pro
Thinking: off, high o max

Antes del turno real, hace una llamada pequeña de enrutamiento para analizar la petición y el contexto. Las tareas simples pueden usar Flash con thinking desactivado; tareas complejas pueden subir a Pro o mayor thinking.

auto es local a DeepSeek-TUI. La API upstream recibe el modelo concreto elegido.

Modos

Modo	Uso
Plan	Exploración y planificación de solo lectura
Agent	Modo interactivo con aprobaciones
YOLO	Autoaprobación en workspaces confiables

YOLO es rápido pero riesgoso. Úsalo solo en ramas temporales o directorios de prueba.

Herramientas

Incluye lectura/escritura de archivos, apply patch, shell, git, web search/browse, subagentes, MCP, diagnósticos LSP, guardado/reanudación de sesiones, rollback del workspace, cola de tareas durable, HTTP/SSE runtime API y sistema de skills.

Los diagnósticos LSP ayudan a devolver errores de rust-analyzer, pyright, typescript-language-server, gopls o clangd al modelo después de editar. El rollback usa snapshots side-git y comandos como /restore y revert_turn, pero los commits normales de git siguen siendo importantes.

Comandos comunes

deepseek
deepseek "explain this function"
deepseek --model deepseek-v4-flash "summarize"
deepseek --model auto "fix this bug"
deepseek --yolo
deepseek auth set --provider deepseek
deepseek doctor
deepseek doctor --json
deepseek models
deepseek sessions
deepseek resume --last
deepseek resume <SESSION_ID>
deepseek fork <SESSION_ID>
deepseek serve --http
deepseek serve --acp
deepseek pr <N>
deepseek mcp list
deepseek mcp validate
deepseek update

Zed y ACP

{
  "agent_servers": {
    "DeepSeek": {
      "type": "custom",
      "command": "deepseek",
      "args": ["serve", "--acp"],
      "env": {}
    }
  }
}

El README indica que ACP permite nuevas sesiones y respuestas a prompts, pero la edición con herramientas y la repetición de checkpoints aún no están expuestas.

Configuración y proveedores

Configuración de usuario:

`1`	`~/.deepseek/config.toml`

Overlay de proyecto:

`1`	`<workspace>/.deepseek/config.toml`

Campos como api_key, base_url, provider y mcp_config_path no se permiten en el overlay del proyecto.

Endpoint compatible con OpenAI:

1
2

deepseek auth set --provider openai --api-key "YOUR_OPENAI_COMPATIBLE_API_KEY"
OPENAI_BASE_URL="https://openai-compatible.example/v4" deepseek --provider openai --model glm-5

Ollama:

1
2

ollama pull deepseek-coder:1.3b
deepseek --provider ollama --model deepseek-coder:1.3b

Resumen

DeepSeek-TUI reúne DeepSeek V4, TUI, llamadas a herramientas, diagnósticos LSP, recuperación de sesiones, rollback, MCP y skills en un flujo Rust de terminal. No es el cliente más ligero, pero su valor está en pasar del chat al desarrollo local ejecutable.

Terminal Tools on KnightLi Blog