DeepWorkPlan Vim

DeepWorkPlan Vim es el editor de terminal de Deep Work Plan: una configuración de Neovim para personas, y para agentes de programación, que trabajan en una terminal. Tus planes, tu documentación y un índice de todos los comandos quedan a una tecla de distancia.

Es un producto aparte, ofrecido como el addon opcional vim de Deep Work Plan v7 (v7.0.0). Deep Work Plan funciona con cualquier editor o con ninguno, y el editor no requiere Deep Work Plan: lo añades a una máquina por separado y funciona como editor haya o no un plan. Esta página describe la versión v0.5.0.

Por qué un editor de terminal para Deep Work Plan

Un Deep Work Plan es una carpeta de Markdown bajo .dwp/plans/: un objetivo, tareas atómicas, puertas de validación y un registro continuo. Las personas lo revisan, los agentes lo ejecutan, y unos y otros suelen hacerlo desde una terminal. Un editor pensado para ese trabajo mantiene cerca tres cosas: el plan, la documentación que lo rodea y las teclas que te mueven entre ambos.

DeepWorkPlan Vim es ese editor. Es una configuración de Neovim cuidada —servidores de lenguaje, autocompletado, linting, formateo, búsqueda difusa, un árbol de archivos y temas de color curados, con carga diferida— más las pocas superficies que lo convierten en el editor de Deep Work Plan.

El recorrido: un índice de comandos que no puede desactualizarse

Pulsa SPC h h (Espacio es la tecla líder), o ejecuta :DwpCommands, y el editor lista todos los atajos que tiene con una descripción de una línea. La lista se genera a partir de los atajos activos, así que un atajo definido en cualquier sitio aparece en el índice sin registrarlo, y el índice no puede quedarse obsoleto.

Ese es todo el recorrido: abre nvim y pulsa Espacio, h, h.

Qué obtienes

Cinco funciones, cada una a una tecla de distancia.

Planes sin salir del editor

SPC P, :DwpPlans o un clic en el segmento de la línea de estado abre la barra lateral de planes. Cubre cada carpeta .dwp/plans/ del directorio actual y del directorio de configuración de Neovim, y agrupa los planes empezando por los que más atención piden. En el editor las etiquetas son Working, Needs attention, Ready, Not started y Done. Cada plan muestra una barra de progreso.

Pulsa Intro sobre un plan para abrir el lector: el objetivo en una frase, el estado y el progreso, la lista de tareas con la tarea actual marcada y saltos en lenguaje claro a los archivos del propio plan. La línea de estado muestra el plan activo en vivo y la pantalla de inicio lista los tres primeros. Estas superficies explican los planes; nunca escriben en .dwp/.

Para leer en el sitio los archivos Markdown de un plan, SPC m p previsualiza el búfer actual en el navegador y SPC m r lo renderiza dentro del búfer. Ambos funcionan solo en búferes de Markdown.

Instalación

La instalación son tres comandos: descarga el script, compruébalo con el SHA-256 del archivo que sirve este sitio y luego ejecútalo. El instalador fija su propia versión, así que instala exactamente v0.5.0, la versión que describe esta página, salvo que elijas otra versión.

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
echo "4890c140528d6b8d19b6bbc4102051e0b9dce2e26f43a693bdeab2e1cd8e196b  install.sh" | shasum -a 256 -c && \
bash install.sh

En orden, el instalador:

1. Comprueba tu sistema operativo y tu gestor de paquetes, e instala git, curl y un intérprete de Lua si falta alguno (ninguno con --skip-packages).
2. Resuelve la versión: su propia versión, o la que pida --version.
3. Con --nvim X.Y.Z, instala esa versión de Neovim en ~/.local/opt, verificada con el SHA-256 que publica Neovim.
4. Pregunta antes de tocar una configuración de Neovim existente. Sin terminal, se detiene y no cambia nada, salvo que --yes le indique que aparte esa configuración.
5. Clona el repositorio en ~/.config/nvim, o lo actualiza si ya está ahí.
6. Ejecuta el propio lua install.lua del repositorio.
7. Instala los plugins sin interfaz y los comprueba, así que no hace falta salir y volver a abrir. Con --strict, una instalación de plugins fallida o incompleta es un error.

El script que se sirve aquí es una copia idéntica byte a byte de install.sh en la etiqueta v0.5.0. Su suma de comprobación se sirve a su lado, en https://deepworkplan.com/vim/install.sh.sha256, así que puedes verificar la descarga con shasum -a 256 -c install.sh.sha256 (en Linux, sha256sum -c install.sh.sha256). Para una comprobación desde un segundo origen, compárala con la línea de install.sh de SHA256SUMS en la versión publicada en GitHub. Ejecuta bash install.sh --help para ver todas las opciones.

Elegir una versión

Por defecto, el instalador instala su propia versión, v0.5.0. Para elegir otra, define DWP_VIM_VERSION o pasa --version: ambos hacen lo mismo, así que usa el que se lea mejor; una opción tiene prioridad sobre el entorno. Cada uno acepta:

Después de la descarga y de la comprobación de la suma anteriores:

# exact version
DWP_VIM_VERSION=0.5.0 bash install.sh
bash install.sh --version 0.5.0

# minimum floor: the newest stable release at or above 0.4.2
DWP_VIM_VERSION='>=0.4.2' bash install.sh

# latest stable release
bash install.sh --version latest

Pon el mínimo entre comillas, para que el shell no interprete > como una redirección. Las versiones solo se resuelven a etiquetas de versiones estables. Para una rama o un commit, define en su lugar DWP_VIM_REF (DWP_VIM_REF=main sigue main); una versión y una referencia que no coinciden son un error.

Contenedores y CI

En una imagen o un trabajo de CI, donde no hay terminal y a menudo tampoco root, descarga y verifica el script, y luego ejecútalo en un solo paso con opciones que hacen reproducible el resultado:

curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
sha256sum -c install.sh.sha256 && \
bash install.sh --version 0.5.0 --nvim 0.12.5 --skip-packages --strict

• --version 0.5.0 fija la versión del editor.
• --nvim 0.12.5 instala esa versión de Neovim en ~/.local/opt/nvim-v0.12.5, enlazada como ~/.local/bin/nvim y verificada con el SHA-256 que publica Neovim (Linux y macOS).
• --skip-packages no instala ningún paquete del sistema: la imagen ya debe proporcionar git, curl y Lua.
• --strict termina con un código distinto de cero cuando la instalación de plugins sin interfaz falla o deja plugins sin instalar.

Cada opción tiene una variable de entorno equivalente (DWP_VIM_VERSION, DWP_VIM_NVIM, DWP_VIM_SKIP_PACKAGES=1, DWP_VIM_STRICT=1). Añade --yes solo cuando la imagen pueda contener ya una configuración de Neovim que deba apartarse.

Requisitos y plataformas

• Neovim 0.12 o más reciente. Instálalo tú mismo, o deja que el instalador añada una versión verificada con --nvim X.Y.Z (Linux y macOS).
• Lua: lua, lua5.4 o luajit. El instalador añade uno si falta.
• macOS, Linux y WSL ejecutan el instalador. Windows tiene una ruta manual documentada en el README del repositorio: instala Neovim con winget, clona la etiqueta v0.5.0 en %LOCALAPPDATA%\nvim y ejecuta lua install.lua desde Git Bash.
• Licencia GPL-3.0: libre de usar, estudiar y modificar.

Actualizar, fijar versión y desinstalar

Para actualizar, ejecuta el instalador de una versión más reciente, o ejecuta bash install.sh --version latest. Volver a ejecutarlo mueve una instalación existente de DeepWorkPlan Vim a la versión elegida, conserva tus ramas y nunca descarta los cambios locales: cuando se perderían cambios o commits locales, se detiene y no cambia nada.

Para fijar una versión, usa --version (consulta Elegir una versión); para una rama o un commit, define DWP_VIM_REF. Prefiere una versión publicada: las versiones anteriores a v0.4.0 no incluyen los gestos, el navegador de planes, el visor de Markdown ni este instalador.

# pin a specific release, here the previous one
curl -fsSL -o install.sh https://deepworkplan.com/vim/install.sh && \
curl -fsSL -o install.sh.sha256 https://deepworkplan.com/vim/install.sh.sha256 && \
shasum -a 256 -c install.sh.sha256 && \
bash install.sh --version 0.4.2

Para desinstalar, ejecuta lua delete.lua desde el directorio de configuración. Elimina la configuración, los plugins, los datos de Mason, la caché y el estado, y la copia de la fuente que hizo el instalador, y deja intactos el binario de Neovim y tus paquetes del sistema.

cd ~/.config/nvim && lua delete.lua

Preguntas

¿Sobrescribirá mi configuración de Neovim?

No, no sin tu aprobación. Cuando encuentra una configuración que no es DeepWorkPlan Vim, una ejecución interactiva pregunta antes de moverla a ~/.config/previous-deepworkplan-vim. Sin terminal, se detiene y no cambia nada, salvo que pases --yes para apartarla sin intervención. Si esa ruta de copia ya existe, siempre se detiene y no cambia nada.

¿Funciona en Windows?

El instalador no se ejecuta en Windows. Usa la ruta manual del README del repositorio, o ejecuta el instalador dentro de WSL.

¿Necesito Deep Work Plan para usarlo?

No. Es un editor ante todo. No instala ni requiere la skill de Deep Work Plan; el navegador de planes simplemente no tiene nada que listar hasta que existe una carpeta .dwp/plans/.

¿Cómo lo usa el addon vim de v7?

Deep Work Plan v7 ofrece el editor como el addon opcional vim durante el onboarding. El addon detecta una instalación existente en modo de solo lectura, a través del addon/surface.json del editor, y ofrece la instalación fijada y verificada con suma de comprobación solo con tu consentimiento. Nunca sobrescribe una configuración de Neovim existente sin aprobación explícita, y nunca es obligatorio.

¿Cómo lo usan los agentes de programación?

Está pensado para personas y para agentes de programación que viven en una terminal. Sus atajos están fijados por pruebas de contrato, así que la memoria muscular, y lo que espera un agente, sobreviven a las actualizaciones.

¿Qué versión obtengo?

El instalador instala la versión a la que pertenece —hoy, v0.5.0— salvo que elijas otra con --version o DWP_VIM_VERSION: una versión exacta, un mínimo >= o latest. DWP_VIM_REF acepta una rama o un commit; DWP_VIM_REF=main sigue main. Esta página describe la versión v0.5.0, que incluye todas las funciones enumeradas aquí.

¿Bajo qué licencia está y de dónde viene?

GPL-3.0. Deriva de mu-vim, de Andrés M Prieto, y el crédito se mantiene en el repositorio.

Código fuente y licencia

El código está en el repositorio de DeepWorkPlan Vim. Es público y tiene licencia GPL-3.0, derivado de mu-vim.

Entradas relacionadas del kit

• Devcontainer — entorno de desarrollo reproducible (primer addon)
• Dailybot — reportes del ciclo de vida del plan visibles para el equipo (segundo addon)
• AI Diff Reviewer — revisión local durante las revisiones finales del plan (quinto addon)
• Herdr — delegar una tarea a un agente par en un panel de Herdr (v7)
• Agentkit — un solo comando para cada agente de programación de terminal, y delegación headless (v7)