Skip to content
← Torna al kit

DeepWorkPlan Vim

DeepWorkPlan Vim è l’editor da terminale di Deep Work Plan: una configurazione Neovim per le persone, e per gli agenti di programmazione, che lavorano in un terminale. I Suoi piani, la documentazione e un indice di tutti i comandi sono a un tasto di distanza.

È un prodotto separato, offerto come addon facoltativo vim di Deep Work Plan v7 (pack v7.9.0). Deep Work Plan funziona con qualsiasi editor o con nessuno, e l’editor non richiede Deep Work Plan: lo si aggiunge a una macchina da solo e funziona come editor che esista o meno un piano. Questa pagina descrive la release v1.0.1, una release di manutenzione della prima release stabile, v1.0.0: da v1.0.0 in poi, l’installer e i suoi flag (con le corrispondenti variabili DWP_VIM_*), la superficie dell’addon (addon/surface.json, interfaccia 1), i comandi dell’editor :DwpPlans, :DwpLanes, :DwpCommands e :DwpConfig, le chiavi di dwpvim.json e le scorciatoie da tastiera fissate dal contratto di mappatura cambiano in modo incompatibile solo in una nuova versione major.

Perché un editor da terminale per Deep Work Plan

Un Deep Work Plan è una cartella di Markdown in .dwp/plans/: un obiettivo, task atomici, validation gate e un registro continuo. Le persone lo rivedono, gli agenti lo eseguono, e gli uni e gli altri lo fanno spesso da un terminale. Un editor pensato per questo lavoro tiene vicine tre cose: il piano stesso, la documentazione che lo circonda e i tasti che permettono di passare dall’uno all’altra.

DeepWorkPlan Vim è quell’editor. L’obiettivo è un piccolo VS Code nel terminale: navigare tra i file, vedere quali file sono cambiati, rivedere il diff e approvare o scartare le modifiche, in modo amichevole e leggero, con gli agenti al primo posto e lo stato del piano sempre in vista. È una configurazione Neovim curata — language server, completamento, formattazione, ricerca fuzzy, un albero dei file e temi di colore selezionati, caricati in modo differito — più le poche superfici che ne fanno l’editor per Deep Work Plan.

Il tour: un indice dei comandi che non può invecchiare

Prema SPC h h (Spazio è il tasto leader), oppure esegua :DwpCommands, e l’editor elenca ogni mappatura che possiede con una descrizione di una riga. L’elenco è generato dalle mappature attive, quindi una mappatura definita ovunque compare nell’indice senza essere registrata, e l’indice non può diventare obsoleto.

Questo è l’intero tour: avvii nvim, poi prema Spazio, h, h.

Che cosa si ottiene

Cinque funzioni, ciascuna a un tasto di distanza.

Funzione Tasti Che cosa fa
Indice dei comandi generato SPC h h Ogni mappatura della configurazione, generata dalle mappature attive.
Gesti in stile VS Code <C-a>, SPC y Selezionare l’intero file con un tasto e copiare negli appunti di sistema. Anche un semplice y finisce lì, perché gli appunti sono quelli di sistema; dove non esiste alcuno strumento per gli appunti (un container, una sessione SSH), la copia viaggia tramite OSC 52.
Browser dei piani di Deep Work Plan SPC P Una barra laterale sui piani del Suo repository, raggruppati per stato e con barre di avanzamento; un clic su un piano ne apre il lettore.
Visualizzatore Markdown SPC m p, SPC m r Anteprima del Markdown nel browser, oppure rendering nel buffer.
Installer verificato — Un installer autonomo per macOS, Linux e WSL, con un percorso manuale documentato per Windows.

I piani senza lasciare l’editor

SPC P, :DwpPlans o un clic sul segmento della riga di stato apre la barra laterale dei piani. Copre ogni cartella .dwp/plans/ della directory corrente e della directory di configurazione di Neovim e ordina i piani partendo da quelli che richiedono più attenzione. Nell’editor le etichette sono Working, Needs attention, Ready, Not started e Done. Ogni piano mostra una barra di avanzamento.

Faccia clic su un piano, oppure prema Invio su di esso, per aprire il lettore: l’obiettivo in una frase, lo stato e l’avanzamento, l’elenco dei task con quella corrente evidenziata e collegamenti in linguaggio semplice ai file del piano stesso. La riga di stato mostra il piano attivo in tempo reale e la schermata iniziale elenca i primi tre. Queste superfici spiegano i piani; non scrivono mai in .dwp/.

La barra laterale risponde al mouse e alla tastiera. La piccola freccia accanto a un piano mostra o nasconde i suoi task e i suoi file, e un clic su un task o su un file lo apre. j, k, i tasti freccia, Ctrl-n e Ctrl-p saltano da un piano all’altro, ignorando righe vuote e decorazioni. Ogni sezione mostra il proprio conteggio, i colori di stato segnano l’icona e la barra di avanzamento, i piani attivi hanno titoli in evidenza e quelli conclusi titoli attenuati, e un gruppo Done con più di sei piani si apre compresso. La finestra è di sola lettura e silenziosa: i tasti di modifica non fanno nulla invece di stampare un errore.

Piani e albero dei file si alternano: aprire una barra laterale chiude l’altra, così si guarda una cosa alla volta. Il lettore si chiude insieme alla barra laterale dei piani. Se aprire una barra laterale chiuda l’altra lo decide la chiave sidebars.exclusive in dwpvim.json.

Un piano orchestratore — un lead che coordina corsie in altri repository — ha anche una vista delle corsie in sola lettura: :DwpLanes, o L nella barra laterale dei piani. Legge le tabelle delle corsie del piano e mostra lo stato in tempo reale di ogni corsia da herdr-peers lanes; se nessun Herdr è raggiungibile, lo segnala e mostra solo le tabelle. Vedi Eseguire molti agenti.

Per leggere sul posto i file Markdown di un piano, SPC m p mostra l’anteprima del buffer corrente nel browser e SPC m r lo renderizza nel buffer. Entrambi funzionano solo nei buffer Markdown.

La dashboard

La schermata iniziale è propria di DeepWorkPlan Vim. Mostra il logo di Deep Work Plan inciso in caratteri braille con un minuscolo VIM sotto la P, un riconoscimento «powered by Dailybot» più in basso e, a destra, una scena incisa: il faro di Deep Work Plan e una nave che naviga nel suo mare. Il fascio di luce pulsa lentamente finché la dashboard è sullo schermo; imposti vim.g.dwp_greeter_pulse = false per disattivarlo.

La scena esiste in sei altezze, scelte in base alle righe che la finestra lascia libere. In una finestra più stretta il logotipo si impila sopra la scena oppure compare da solo. Le finestre larghe mostrano affiancati le scorciatoie e «Your plans», quelle strette li impilano. Prema Invio per attivare la riga sotto il cursore; SPC P apre la barra laterale dei piani.

Configurare le barre laterali

Un file dwpvim.json stabilisce da che lato si trovano le due barre laterali e quanto sono larghe. Il file nella directory dell’editor (~/.config/nvim) vale per ogni progetto, e un .dwpvim.json nella directory da cui avvia Neovim lo sostituisce per quel progetto. Le impostazioni vengono lette all’avvio, quindi riavvii Neovim dopo aver modificato un file.

{
  "tree":  { "side": "left", "width": 40 },
  "plans": { "side": "left", "width": 48 },
  "sidebars": { "exclusive": true }
}
Chiave Valori Predefinito Che cosa fa
tree.side "left" o "right" "left" Lato dell’albero dei file (SPC n)
tree.width numero intero, da 20 a 120 40 Larghezza massima dell’albero; si restringe comunque al contenuto
plans.side "left" o "right" "left" Lato della barra laterale dei piani (SPC P)
plans.width numero intero, da 20 a 120 48 Larghezza massima della barra laterale dei piani
sidebars.exclusive true o false true Una sola barra laterale alla volta; con false restano aperte entrambe

Un file mancante non è un problema. Un file che non è JSON valido, una chiave sconosciuta o un valore non valido vengono ignorati e segnalati, mai fatali. Esegua :DwpConfig per vedere ogni valore in vigore, il file da cui proviene e gli eventuali problemi rilevati.

Un editor più leggero

La versione 0.6.0 rimuove ciò che nessuno usava, così ci sono meno plugin da fissare e meno pacchetti da installare e aggiornare al primo avvio:

  • Undici language server di Mason sono ritirati: efm, diagnosticls, tailwindcss, grammarly, bashls e i server per astro, svelte, Vue 2, Angular, SQL e Vim script.
  • nvim-lint è rimosso, perché non è mai stato configurato alcun linter.
  • Le voci del formatter prettier sono rimosse, perché nulla installava prettier. :Format mantiene biome, black, shfmt e stylua.
  • marksman resta per seguire i link, completare link e intestazioni e per la struttura del documento, con le sue diagnostiche silenziate. Markdown resta senza formatter di proposito.

Sono abilitati solo i server elencati dalla configurazione, anche quando Mason ne conserva altri da una configurazione precedente. Ogni plugin, server e strumento, con il motivo per cui è presente, è elencato in PLUGINS.md.

Installazione

L’installazione è composta da tre comandi: scarichi lo script, lo verifichi con lo SHA-256 del file servito da questo sito, poi lo esegua. L’installer fissa la propria release, quindi installa esattamente v1.0.1, la release descritta in questa pagina, a meno che non scelga un’altra versione.

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

Controlli prima di eseguire

Preferisce leggerlo prima? Scarichi lo script, verifichi la sua impronta, lo legga e poi lo esegua.

  1. Scaricare lo script
    curl -fsSL https://deepworkplan.com/vim/install.sh -o install.sh
  2. Stampare lo SHA-256 e confrontarlo con il valore qui sotto
    sha256sum install.sh
  3. Leggere lo script
    less install.sh
  4. Eseguire lo script
    bash install.sh
SHA-256 dello script servito ora
24a550239108a71434e993675389c27c64d88c4c07af8efc9be98d23897fb716
46504 byte · 1109 righe

Su macOS, per il secondo passaggio usi shasum -a 256 install.sh.

Per scegliere una versione, passi --version o imposti DWP_VIM_VERSION: una versione esatta, un minimo '>=' o latest. DWP_VIM_REF accetta un ramo o un commit. Le versioni meno recenti potrebbero non includere tutte le funzioni descritte in questa pagina.

Su Windows questi comandi non si applicano; il README del repository descrive il percorso manuale. Percorso di installazione su Windows

In ordine, l’installer:

  1. Controlla il sistema operativo e il gestore di pacchetti e installa git, curl e un interprete Lua se ne manca qualcuno (nessuno con --skip-packages).
  2. Risolve la versione: la propria release, oppure quella richiesta da --version.
  3. Con --nvim X.Y.Z, installa quella release di Neovim in ~/.local/opt, verificata con lo SHA-256 pubblicato da Neovim.
  4. Chiede prima di toccare una configurazione Neovim esistente. Senza terminale, si ferma e non cambia nulla, a meno che --yes non gli indichi di spostare da parte quella configurazione.
  5. Clona il repository in ~/.config/nvim oppure lo aggiorna se è già presente.
  6. Esegue il lua install.lua del repository.
  7. Installa i plugin in modalità headless e li verifica, quindi non serve chiudere e riaprire. Con --strict, un’installazione dei plugin non riuscita o incompleta è un errore.

Lo script servito qui è una copia identica byte per byte di install.sh al tag v1.0.1. Il suo checksum è servito accanto, all’indirizzo https://deepworkplan.com/vim/install.sh.sha256, quindi può verificare il download con shasum -a 256 -c install.sh.sha256 (su Linux, sha256sum -c install.sh.sha256). Per una verifica da una seconda origine, lo confronti con la riga di install.sh in SHA256SUMS nella release su GitHub. Esegua bash install.sh --help per elencare tutte le opzioni.

Scegliere una versione

Per impostazione predefinita l’installer installa la propria release, v1.0.1. Per sceglierne un’altra, imposti DWP_VIM_VERSION o passi --version: fanno la stessa cosa, quindi usi quello che si legge meglio; un’opzione prevale sull’ambiente. Ciascuno accetta:

Forma Esempio Installa
Versione esatta 1.0.0 o v1.0.0 Quella release
Versione minima '>=0.4.2' La release stabile più recente pari o superiore al minimo
Più recente latest La release stabile più recente

Dopo il download e la verifica del checksum descritti sopra:

# exact version
DWP_VIM_VERSION=1.0.0 bash install.sh
bash install.sh --version 1.0.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

Metta il minimo tra virgolette, così che la shell non interpreti > come un reindirizzamento. Le versioni si risolvono solo in tag di release stabili. Per un ramo o un commit, imposti invece DWP_VIM_REF (DWP_VIM_REF=main segue main); una versione e un riferimento in disaccordo sono un errore.

Container e CI

In un’immagine o in un job di CI, dove non c’è un terminale e spesso nemmeno l’accesso root, scarichi e verifichi lo script, poi lo esegua in un solo passaggio con opzioni che rendono il risultato riproducibile:

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 1.0.0 --nvim 0.12.5 --skip-packages --strict
  • --version 1.0.0 fissa la release dell’editor.
  • --nvim 0.12.5 installa quella release di Neovim in ~/.local/opt/nvim-v0.12.5, collegata come ~/.local/bin/nvim e verificata con lo SHA-256 pubblicato da Neovim (Linux e macOS).
  • --skip-packages non installa alcun pacchetto di sistema: l’immagine deve già fornire git, curl e Lua.
  • --strict termina con un codice diverso da zero quando l’installazione headless dei plugin non riesce o lascia plugin mancanti. Verifica anche che ogni plugin, e pckr, sia al commit che la release fissa in pckr/lockfile.lua.

Ogni opzione ha una variabile d’ambiente equivalente (DWP_VIM_VERSION, DWP_VIM_NVIM, DWP_VIM_SKIP_PACKAGES=1, DWP_VIM_STRICT=1). Aggiunga --yes solo quando l’immagine può già contenere una configurazione Neovim da spostare da parte.

Requisiti e piattaforme

  • Neovim 0.12 o successivo. Lo installi da sé, oppure lasci che l’installer aggiunga una release verificata con --nvim X.Y.Z (Linux e macOS).
  • Lua: lua, lua5.4 o luajit. L’installer ne aggiunge uno se manca.
  • macOS, Linux e WSL eseguono l’installer. Windows ha un percorso manuale documentato nel README del repository: installare Neovim con winget, clonare il tag v1.0.1 in %LOCALAPPDATA%\nvim ed eseguire lua install.lua da Git Bash.
  • Licenza GPL-3.0: libero da usare, studiare e modificare.

Aggiornare, fissare la versione e disinstallare

Per aggiornare, esegua l’installer di una release più recente, oppure esegua bash install.sh --version latest. Rieseguirlo sposta un checkout esistente di DeepWorkPlan Vim alla release scelta, conserva i suoi rami e non azzera mai le modifiche locali: quando andrebbero perse modifiche o commit locali, si ferma e non cambia nulla.

Per fissare una release, usi --version (si veda Scegliere una versione); per un ramo o un commit, imposti DWP_VIM_REF. Preferisca una release: le release precedenti a v0.4.0 non includono i gesti, il browser dei piani, il visualizzatore Markdown né questo 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.5.1

Per disinstallare, esegua lua delete.lua dalla directory di configurazione. Rimuove la configurazione, i plugin, i dati di Mason, la cache e lo stato e la copia del font fatta dall’installer, e lascia intatti il binario di Neovim e i pacchetti di sistema.

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

Domande

Sovrascriverà la mia configurazione di Neovim?

No, non senza la Sua approvazione. Quando trova una configurazione che non è DeepWorkPlan Vim, un’esecuzione interattiva chiede prima di spostarla in ~/.config/previous-deepworkplan-vim. Senza terminale si ferma e non cambia nulla, a meno che non passi --yes per spostarla da parte senza intervento. Se quel percorso di backup esiste già, si ferma sempre e non cambia nulla.

Funziona su Windows?

L’installer non funziona su Windows. Usi il percorso manuale del README del repository, oppure esegua l’installer dentro WSL.

Mi serve Deep Work Plan per usarlo?

No. È prima di tutto un editor. Non installa né richiede la skill di Deep Work Plan; il browser dei piani semplicemente non ha nulla da elencare finché non esiste una cartella .dwp/plans/.

Come lo usa l’addon vim della v7?

Deep Work Plan v7 offre l’editor come addon facoltativo vim durante l’onboarding. L’addon rileva un’installazione esistente in sola lettura, tramite il file addon/surface.json dell’editor, e offre l’installazione fissata e verificata tramite checksum solo con il Suo consenso. Non sovrascrive mai una configurazione Neovim esistente senza un’approvazione esplicita, e non è mai obbligatorio.

Come lo usano gli agenti di programmazione?

È pensato per le persone e per gli agenti di programmazione che vivono in un terminale. Le sue combinazioni di tasti sono fissate da test di contratto, quindi la memoria muscolare, e ciò che un agente si aspetta, sopravvivono agli aggiornamenti.

Quale versione ottengo?

L’installer installa la release a cui appartiene — oggi v1.0.1 — a meno che non ne scelga un’altra con --version o DWP_VIM_VERSION: una versione esatta, un minimo >= o latest. DWP_VIM_REF accetta un ramo o un commit; DWP_VIM_REF=main segue main. Questa pagina descrive la release v1.0.1, che include tutte le funzioni elencate qui.

Con quale licenza è distribuito e da dove deriva?

GPL-3.0. Deriva da mu-vim di Andrés M Prieto e il riconoscimento resta nel repository.

Codice sorgente e licenza

Il codice sorgente è nel repository di DeepWorkPlan Vim. È pubblico e con licenza GPL-3.0, derivato da mu-vim.

Voci correlate del kit

  • Devcontainer — ambiente di sviluppo riproducibile (primo addon)
  • Dailybot — report del ciclo di vita del piano visibili al team (secondo addon)
  • AI Diff Reviewer — revisione locale durante le Final Review del piano (quinto addon)
  • Herdr — delegare un task a un agente peer in un pannello Herdr (v7)
  • Agentkit — un solo comando per ogni agente di programmazione da terminale, e delega headless (v7)