DeepWorkPlan Vim

DeepWorkPlan Vim ist der Terminal-Editor für Deep Work Plan: eine Neovim-Konfiguration für Menschen und für Coding-Agenten, die im Terminal arbeiten. Ihre Pläne, Ihre Dokumentation und ein Index aller Befehle sind einen Tastendruck entfernt.

Es ist ein eigenständiges Produkt, angeboten als optionales vim-Addon von Deep Work Plan v7 (v7.0.0). Deep Work Plan funktioniert mit jedem Editor oder ganz ohne, und der Editor setzt Deep Work Plan nicht voraus: Sie fügen ihn einer Maschine separat hinzu, und er funktioniert als Editor, ob ein Plan existiert oder nicht. Diese Seite beschreibt Release v0.5.0.

Warum ein Terminal-Editor für Deep Work Plan

Ein Deep Work Plan ist ein Ordner mit Markdown unter .dwp/plans/: ein Ziel, atomare Aufgaben, Validierungs-Gates und ein laufendes Protokoll. Menschen prüfen ihn, Agenten führen ihn aus, und beide tun das oft im Terminal. Ein Editor für diese Arbeit hält drei Dinge nah beieinander: den Plan selbst, die Dokumentation drumherum und die Tasten, die Sie zwischen beiden bewegen.

DeepWorkPlan Vim ist dieser Editor. Er ist eine kuratierte Neovim-Konfiguration — Language Server, Vervollständigung, Linting, Formatierung, Fuzzy-Suche, ein Dateibaum und ausgewählte Farbschemata, lazy geladen — plus die wenigen Oberflächen, die ihn zum Editor für Deep Work Plan machen.

Die Tour: ein Befehlsindex, der nicht veralten kann

Drücken Sie SPC h h (Leertaste ist die Leader-Taste) oder führen Sie :DwpCommands aus, und der Editor listet jede Belegung mit einer einzeiligen Beschreibung auf. Die Liste wird aus den aktuellen Tastenbelegungen erzeugt, sodass eine irgendwo definierte Belegung ohne Registrierung im Index erscheint und der Index nicht veralten kann.

Das ist die ganze Tour: nvim starten, dann Leertaste, h, h drücken.

Was Sie bekommen

Fünf Funktionen, jede einen Tastendruck entfernt.

Pläne, ohne den Editor zu verlassen

SPC P, :DwpPlans oder ein Klick auf das Statuszeilen-Segment öffnet die Plan-Seitenleiste. Sie deckt jeden .dwp/plans/-Ordner im aktuellen Verzeichnis und in Ihrem Neovim-Konfigurationsverzeichnis ab und gruppiert die Pläne nach dem größten Aufmerksamkeitsbedarf zuerst. Im Editor lauten die Bezeichnungen Working, Needs attention, Ready, Not started und Done. Jeder Plan zeigt einen Fortschrittsbalken.

Drücken Sie die Eingabetaste auf einem Plan, um den Reader zu öffnen: das Ziel in einem Satz, Status und Fortschritt, die Aufgabenliste mit markierter aktueller Aufgabe und Sprünge in verständlicher Sprache zu den Dateien des Plans. Die Statuszeile zeigt den aktuell aktiven Plan, und der Startbildschirm listet die obersten drei. Diese Oberflächen erklären Pläne; sie schreiben nie unter .dwp/.

Um die Markdown-Dateien eines Plans an Ort und Stelle zu lesen, zeigt SPC m p den aktuellen Puffer im Browser an und SPC m r rendert ihn im Puffer. Beides funktioniert nur in Markdown-Puffern.

Installation

Die Installation besteht aus drei Befehlen: Laden Sie das Skript herunter, prüfen Sie es gegen das SHA-256 der Datei, die diese Website ausliefert, und führen Sie es dann aus. Der Installer legt sein eigenes Release fest und installiert daher genau v0.5.0, das Release, das diese Seite beschreibt, sofern Sie nicht eine andere Version wählen.

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

Der Installer erledigt der Reihe nach:

1. Er prüft Betriebssystem und Paketmanager und installiert git, curl und einen Lua-Interpreter, falls einer fehlt (mit --skip-packages nichts davon).
2. Er löst die Version auf: sein eigenes Release oder dasjenige, das --version anfordert.
3. Mit --nvim X.Y.Z installiert er dieses Neovim-Release nach ~/.local/opt, verifiziert gegen das SHA-256, das Neovim veröffentlicht.
4. Er fragt nach, bevor er eine vorhandene Neovim-Konfiguration anfasst. Ohne Terminal bricht er ab und ändert nichts, es sei denn, --yes weist ihn an, diese Konfiguration beiseitezuschieben.
5. Er klont das Repository nach ~/.config/nvim oder aktualisiert es, wenn es schon dort liegt.
6. Er führt das eigene lua install.lua des Repositorys aus.
7. Er installiert die Plugins headless und prüft sie, sodass kein Beenden und erneutes Öffnen nötig ist. Mit --strict ist eine fehlgeschlagene oder unvollständige Plugin-Installation ein Fehler.

Das hier ausgelieferte Skript ist eine byte-identische Kopie von install.sh beim Tag v0.5.0. Seine Prüfsumme wird daneben ausgeliefert, unter https://deepworkplan.com/vim/install.sh.sha256, sodass Sie den Download mit shasum -a 256 -c install.sh.sha256 verifizieren können (unter Linux mit sha256sum -c install.sh.sha256). Für eine Prüfung aus einer zweiten Quelle vergleichen Sie sie mit der install.sh-Zeile von SHA256SUMS im GitHub-Release. Führen Sie bash install.sh --help aus, um alle Optionen aufzulisten.

Version wählen

Standardmäßig installiert der Installer sein eigenes Release, v0.5.0. Um ein anderes zu wählen, setzen Sie DWP_VIM_VERSION oder übergeben Sie --version: Beide bewirken dasselbe, verwenden Sie also, was sich besser liest; ein Flag hat Vorrang vor der Umgebung. Beide akzeptieren:

Nach dem Download und der Prüfsummenprüfung oben:

# 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

Setzen Sie die Mindestversion in Anführungszeichen, damit die Shell > nicht als Umleitung liest. Versionen werden nur zu stabilen Release-Tags aufgelöst. Für einen Branch oder einen Commit setzen Sie stattdessen DWP_VIM_REF (DWP_VIM_REF=main folgt main); eine Version und eine Ref, die sich widersprechen, sind ein Fehler.

Container und CI

In einem Image oder einem CI-Job, wo es kein Terminal und oft keinen Root-Zugriff gibt, laden Sie das Skript herunter, verifizieren es und führen es dann in einem Schritt mit Flags aus, die das Ergebnis reproduzierbar machen:

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 legt das Editor-Release fest.
• --nvim 0.12.5 installiert dieses Neovim-Release nach ~/.local/opt/nvim-v0.12.5, verlinkt als ~/.local/bin/nvim und verifiziert gegen das SHA-256, das Neovim veröffentlicht (Linux und macOS).
• --skip-packages installiert kein Systempaket: Das Image muss git, curl und Lua bereits mitbringen.
• --strict beendet sich mit einem Exit-Code ungleich null, wenn die headless Plugin-Installation fehlschlägt oder Plugins fehlen.

Jedes Flag hat ein Gegenstück als Umgebungsvariable (DWP_VIM_VERSION, DWP_VIM_NVIM, DWP_VIM_SKIP_PACKAGES=1, DWP_VIM_STRICT=1). Fügen Sie --yes nur hinzu, wenn das Image bereits eine Neovim-Konfiguration enthalten kann, die beiseitegeschoben werden soll.

Voraussetzungen und Plattformen

• Neovim 0.12 oder neuer. Installieren Sie es selbst, oder lassen Sie den Installer mit --nvim X.Y.Z ein verifiziertes Release hinzufügen (Linux und macOS).
• Lua: lua, lua5.4 oder luajit. Der Installer ergänzt eines, falls es fehlt.
• macOS, Linux und WSL führen den Installer aus. Für Windows gibt es einen dokumentierten manuellen Weg in der README des Repositorys: Neovim mit winget installieren, den Tag v0.5.0 nach %LOCALAPPDATA%\nvim klonen und lua install.lua aus Git Bash ausführen.
• GPL-3.0-lizenziert: frei nutzbar, studierbar und veränderbar.

Aktualisieren, festlegen und deinstallieren

Um zu aktualisieren, führen Sie den Installer eines neueren Releases aus oder bash install.sh --version latest. Ein erneuter Lauf bringt einen vorhandenen DeepWorkPlan-Vim-Checkout auf das gewählte Release, behält Ihre Branches und setzt lokale Änderungen nie zurück: Wenn lokale Änderungen oder Commits verloren gingen, hält er an und ändert nichts.

Um ein Release festzulegen, verwenden Sie --version (siehe Version wählen); für einen Branch oder einen Commit setzen Sie DWP_VIM_REF. Bevorzugen Sie ein Release: Releases vor v0.4.0 enthalten weder die Gesten noch den Plan-Browser, den Markdown-Viewer oder diesen Installer.

# 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

Zum Deinstallieren führen Sie lua delete.lua im Konfigurationsverzeichnis aus. Es entfernt die Konfiguration, die Plugins, die Mason-Daten, Cache und Zustand sowie die vom Installer angelegte Schriftkopie und lässt die Neovim-Binärdatei und Ihre Systempakete unberührt.

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

Fragen

Überschreibt es meine Neovim-Konfiguration?

Nein, nicht ohne Ihre Zustimmung. Findet es eine Konfiguration, die nicht DeepWorkPlan Vim ist, fragt ein interaktiver Lauf nach, bevor er sie nach ~/.config/previous-deepworkplan-vim verschiebt. Ohne Terminal bricht es ab und ändert nichts, es sei denn, Sie übergeben --yes, um sie unbeaufsichtigt beiseitezuschieben. Wenn dieser Sicherungspfad bereits existiert, bricht es immer ab und ändert nichts.

Funktioniert es unter Windows?

Der Installer läuft nicht unter Windows. Nutzen Sie den manuellen Weg aus der README des Repositorys oder führen Sie den Installer in WSL aus.

Brauche ich Deep Work Plan, um es zu nutzen?

Nein. Es ist zuerst ein Editor. Es installiert die Deep-Work-Plan-Skill nicht und setzt sie nicht voraus; der Plan-Browser hat nur nichts aufzulisten, solange kein .dwp/plans/-Ordner existiert.

Wie nutzt das vim-Addon von v7 den Editor?

Deep Work Plan v7 bietet den Editor beim Onboarding als optionales vim-Addon an. Das Addon erkennt eine vorhandene Installation schreibgeschützt über die Datei addon/surface.json des Editors und bietet die festgelegte, per Prüfsumme verifizierte Installation nur mit Ihrer Zustimmung an. Es überschreibt eine vorhandene Neovim-Konfiguration nie ohne ausdrückliche Freigabe und ist nie erforderlich.

Wie nutzen Coding-Agenten es?

Es ist für Menschen und für Coding-Agenten gebaut, die im Terminal leben. Seine Tastenbelegungen sind durch Vertragstests festgelegt, sodass Muskelgedächtnis und die Erwartungen eines Agenten Updates überstehen.

Welche Version bekomme ich?

Der Installer installiert das Release, zu dem er gehört – derzeit v0.5.0 –, sofern Sie nicht mit --version oder DWP_VIM_VERSION ein anderes wählen: eine exakte Version, eine >=-Mindestversion oder latest. DWP_VIM_REF nimmt einen Branch oder einen Commit; DWP_VIM_REF=main folgt main. Diese Seite beschreibt Release v0.5.0, das jede hier aufgeführte Funktion enthält.

Unter welcher Lizenz steht es und woher stammt es?

GPL-3.0. Es leitet sich von mu-vim von Andrés M Prieto ab, und die Namensnennung bleibt im Repository erhalten.

Quellcode und Lizenz

Der Quellcode liegt im DeepWorkPlan-Vim-Repository. Es ist öffentlich und GPL-3.0-lizenziert, abgeleitet von mu-vim.

Verwandte Kit-Einträge

• Devcontainer — reproduzierbare Entwicklungsumgebung (erstes Addon)
• Dailybot — team-sichtbare Plan-Lifecycle-Berichte (zweites Addon)
• AI Diff Reviewer — lokale Prüfung in den Final Reviews des Plans (fünftes Addon)
• Herdr — eine Aufgabe an einen Peer-Agenten in einem Herdr-Pane delegieren (v7)
• Agentkit — ein Befehl für jeden Coding-Agenten im Terminal und Headless-Delegation (v7)