macOS / Linux (Homebrew)```bash

Homebrew

brew install depsguard

Oppure scarica manualmente tramite PowerShell:```powershell $zip = "$env:TEMP\depsguard.zip" Invoke-WebRequest -Uri "https://github.com/arnica/depsguard/releases/latest/download/depsguard-x86_64-pc-windows-msvc.zip" -OutFile $zip Expand-Archive -LiteralPath $zip -DestinationPath "$env:TEMP\depsguard" -Force Copy-Item "$env:TEMP\depsguard\depsguard.exe" "$HOME\AppData\Local\Microsoft\WindowsApps\depsguard.exe" -Force depsguard.exe --help

Richiede una toolchain Rust con cargo.

Gestori di pacchetti (quando pubblicati dal tuo fornitore)

Se la tua organizzazione distribuisce DepsGuard tramite Homebrew, Scoop o WinGet, segui le loro istruzioni. La configurazione o l'automazione di questi canali (PR per Homebrew core, bucket, PR per WinGet, segreti CI) è documentazione per i manutentori; consulta AGENTS.md nella sezione Release & distribution.

App store / gestori di pacchetti

Aggiornamento all'ultima versione

Usa il canale con cui hai effettuato l'installazione:

Controlla la versione installata in qualsiasi momento con depsguard --version e consulta la pagina delle release per la versione più recente.

Compilazione dal sorgente```bash

git clone https://github.com/arnica/depsguard.git cd depsguard cargo build --release

Come usare

1. Installa – scegli la tua piattaforma sopra.
2. Esegui depsguard per avviare la TUI interattiva. Esegue una scansione del sistema e mostra una tabella dei risultati. Premi un tasto qualsiasi per passare al selettore delle correzioni. L'individuazione delle configurazioni a livello di repository parte dalla directory corrente e cerca verso il basso. Usa depsguard scan per un report in sola lettura, oppure depsguard --no-search per saltare la ricerca ricorsiva dei file e controllare solo le configurazioni a livello utente.

   Nota: alcune impostazioni richiedono una versione minima. Se la tua versione è troppo vecchia vedrai: ℹ min-release-age – requires npm ≥ 11.10 (have 10.2.0). Aggiorna con npm install -g npm@latest e riesegui.

3. Naviga e seleziona – usa ↑ ↓ per spostarti nell'elenco (^u ^d per pagina). Premi Spazio per attivare o disattivare una correzione. Usa i tasti di filtro rapido per selezionare in blocco per file: a tutti, n .npmrc, u uv.toml, ecc. – premili una volta per selezionare, di nuovo per deselezionare, una terza volta per cancellare il filtro. Premi f per mostrare solo le correzioni attualmente selezionate.
4. Anteprima – premi d per vedere un diff di ciò che cambierà prima di applicare qualsiasi modifica.
5. Applica – premi Invio per applicare le correzioni selezionate. Viene creato un backup con timestamp prima di scrivere qualsiasi file.
6. Riscansiona – DepsGuard esegue automaticamente una nuova scansione dopo l'applicazione, così puoi verificare che tutto sia a posto.
7. Ripristina – esegui depsguard restore in qualsiasi momento per eseguire il rollback dall'elenco dei backup. Premi q o Esc per uscire.

Cosa viene controllato

Posizioni dei file di configurazione

I file di configurazione a livello utente vengono letti dalle loro posizioni standard (incluse le path basate su XDG dove lo strumento le supporta). Le configurazioni a livello di repository vengono individuate cercando verso il basso dalla directory corrente, saltando le directory note di grandi dimensioni (node_modules, .git, target, Library, .cache e altre) per mantenere veloci le scansioni. Vengono cercate tutte le configurazioni a livello di repository: .npmrc, .yarnrc.yml, pnpm-workspace.yaml, le configurazioni di Renovate e quelle di Dependabot. Le impostazioni di pnpm possono trovarsi in ~/.npmrc (solo pnpm <= 10; pnpm >= 11 legge da .npmrc solo le impostazioni di autenticazione/registro), nel file di configurazione globale di pnpm (rc su pnpm <= 10, config.yaml su pnpm >= 11), oppure in pnpm-workspace.yaml; DepsGuard controlla tutte e tre le posizioni in modo indipendente. Per pip, uv e poetry, DepsGuard individua l'unico file di configurazione utente effettivo e segnala solo quel file, invece di evidenziare separatamente i file sovrascritti. pip e poetry uniscono i loro file di configurazione in base alla precedenza (vince il file con precedenza più alta che imposta il cooldown, oppure la posizione preferita se nessuno lo fa); uv legge un singolo file utente ($XDG_CONFIG_HOME/uv/uv.toml quando XDG_CONFIG_HOME è impostata, altrimenti ~/.config/uv/uv.toml) invece di unire entrambi. Per bun, se esistono più file di configurazione a livello utente (ad esempio sia una path XDG che una path nella home directory), DepsGuard esegue la scansione di ciascun file esistente separatamente. aube legge lo stesso ~/.npmrc di npm/pnpm (minimumReleaseAge, in minuti) e viene controllato anche sui file .npmrc a livello di repository individuati; pip e poetry vengono scansionati nella loro configurazione utente (pip.conf / pypoetry/config.toml).

Correzione di sicurezza urgente

Se la versione corretta è più recente della tua finestra di cooldown, aggiungi un'eccezione limitata, installa la correzione e poi rimuovi l'eccezione.

Preferisci un'eccezione specifica per il pacchetto rispetto all'abbassamento del cooldown globale. In questo modo il ritardo resta attivo per tutte le altre dipendenze.

Prima di bypassare il cooldown:

1. Controlla se la CVE riguarda effettivamente il tuo utilizzo.
2. Controlla se è già disponibile una versione precedente nota come sicura. Un downgrade potrebbe essere più sicuro.
3. Rimuovi le eccezioni temporanee dopo l'aggiornamento.

Backup e ripristino

Prima di modificare un file, DepsGuard scrive un backup in ~/.depsguard/backups/.

Esegui depsguard restore per elencare i backup e ripristinarne uno.

Come funziona```

src/ main.rs CLI args, run loop term.rs Raw mode + input (Unix termios / Windows console FFI) manager.rs Detection, scanning, recommendations fix.rs Read/write .npmrc, TOML, YAML; backup/restore ui.rs Banner, tables, selector