thrunt-god

Dal segnale, allo sciame.
Nessun dio. Solo Thrunt.

Sistema di comandi per threat hunting per IDE agentici.
Claude Code · OpenCode · Gemini · Codex · Copilot · Cursor · Windsurf

/thrunt:autonomous  |  un comando, caccia completa

Installa  ·   Fasi  ·   Comandi  ·   Flussi  ·   Artefatti

Installazione

npx thrunt-god@latest --claude --local

Avvia la superficie di comando di caccia nel tuo ambiente IDE locale.

Installa l'alpha dell'estensione VS Code

Scarica thrunt-god-0.3.0.vsix dalla release v0.3.0.

Poi installala in uno di questi due modi:

1. In VS Code, apri Estensioni, clicca sul menu ..., scegli Installa da VSIX... e seleziona il file scaricato.
2. Dal terminale:

code --install-extension thrunt-god-0.3.0.vsix

Dopo l'installazione, apri una cartella che contenga .planning/MISSION.md o .hunt/MISSION.md e la barra laterale THRUNT si attiverà automaticamente.

Le cinque fasi

Ogni caccia si risolve attraverso cinque fasi. Ogni passaggio è esplicito.

Comandi di caccia

Comandi Thrunt

Comandi di utilità e orchestrazione (/thrunt:*) per la gestione dell'area di lavoro, diagnostica, impostazioni e controllo degli agenti.

Flussi comuni

Artefatti

Tutto lo stato della caccia risiede in una directory di pianificazione alla radice del progetto (.planning/ di default). Ogni query, ricevuta e risultato è un file, non un riepilogo.

.planning/
├── config.json             # Impostazioni di progetto (modalità, profilo, connettori, attivazione flussi di lavoro)
├── MISSION.md              # Missione e ambito del programma di caccia
├── HYPOTHESES.md           # Ipotesi verificabili con monitoraggio dello stato
├── SUCCESS_CRITERIA.md     # Definizione di completamento per il programma
├── HUNTMAP.md              # Scomposizione delle fasi e mappa di esecuzione
├── STATE.md                # Fase corrente, progresso, blocchi
├── FINDINGS.md             # Solo risultati convalidati
├── EVIDENCE_REVIEW.md      # Audit della catena di prove
├── QUERIES/                # Query esatte eseguite, con timestamp
├── RECEIPTS/               # Ricevute di esecuzione per attività di fase
├── DETECTIONS/             # Regole di rilevamento promosse dai risultati
├── environment/
│   └── ENVIRONMENT.md      # Inventario fonti dati e mappa di accesso
├── phases/                 # Piani, ricerche e risultati per fase
├── workstreams/            # Casi di caccia paralleli (opzionale)
├── milestones/             # Traguardi completati archiviati
└── published/              # Deliverable finali

Configurazione

Le impostazioni risiedono in .planning/config.json, creato da /hunt:new-program e modificabile tramite /thrunt:settings. I valori predefiniti globali in ~/.thrunt/defaults.json vengono uniti in ogni nuova configurazione di progetto.

Schema completo e profili connettori: docs/CONFIGURATION.md

Directory di pianificazione personalizzata

Imposta THRUNT_PLANNING_DIR per cambiare il nome della directory. Questo influisce su tutta la risoluzione dei percorsi, il rilevamento della radice del progetto e l'archiviazione degli artefatti.

export THRUNT_PLANNING_DIR=".hunt"

Archiviazione

Per impostazione predefinita, .planning/ viene committato in git in modo che gli artefatti di caccia viaggino con il repository. Per mantenere gli artefatti in locale:

1. Aggiungi .planning/ a .gitignore
2. Imposta planning.commit_docs: false e planning.search_gitignored: true nella configurazione
3. Se precedentemente tracciato: git rm -r --cached .planning/

I flussi di lavoro (/thrunt:new-workspace) creano alberi di artefatti isolati sotto .planning/workstreams/{name}/ per cacce parallele nello stesso progetto.

Il bootstrap riempie immediatamente i campi confermati. TBD contrassegna solo fatti dell'ambiente live o forniti dall'operatore ancora sconosciuti.