thrunt-god

Du signal, à l'essaim.
Pas de dieux. Seulement Thrunt.

Système de commandes de threat hunting pour IDE agentiques.
Claude Code · OpenCode · Gemini · Codex · Copilot · Cursor · Windsurf

/thrunt:autonomous  |  une commande, une chasse complète

Installation  ·   Phases  ·   Commandes  ·   Flux  ·   Artefacts

Installation

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

Amorcez la surface de commandes de chasse dans votre environnement IDE local.

Installer l'extension alpha pour VS Code

Téléchargez thrunt-god-0.3.0.vsix depuis la version v0.3.0.

Installez-la de l'une des deux manières suivantes :

1. Dans VS Code, ouvrez Extensions, cliquez sur le menu ..., choisissez Installer depuis VSIX..., puis sélectionnez le fichier téléchargé.
2. Depuis le terminal :

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

Après l'installation, ouvrez un dossier contenant .planning/MISSION.md ou .hunt/MISSION.md et la barre latérale THRUNT s'activera automatiquement.

Les Cinq Phases

Chaque chasse se déroule en cinq phases. Chaque étape est explicite.

Commandes de Chasse

Commandes Thrunt

Commandes utilitaires et d'orchestration (/thrunt:*) pour la gestion de l'espace de travail, les diagnostics, les paramètres et le contrôle des agents.

Flux Courants

Artefacts

Tout l'état de la chasse réside dans un répertoire de planification à la racine du projet (.planning/ par défaut). Chaque requête, reçu et résultat est un fichier, pas un résumé.

.planning/
├── config.json             # Project settings (mode, profile, connectors, workflow toggles)
├── MISSION.md              # Hunt program mission and scope
├── HYPOTHESES.md           # Testable hypotheses with status tracking
├── SUCCESS_CRITERIA.md     # Definition of done for the program
├── HUNTMAP.md              # Phase breakdown and execution roadmap
├── STATE.md                # Current phase, progress, blockers
├── FINDINGS.md             # Validated findings only
├── EVIDENCE_REVIEW.md      # Evidence chain audit
├── QUERIES/                # Exact queries run, with timestamps
├── RECEIPTS/               # Execution receipts per phase task
├── DETECTIONS/             # Detection rules promoted from findings
├── environment/
│   └── ENVIRONMENT.md      # Data source inventory and access map
├── phases/                 # Per-phase plans, research, and results
├── workstreams/            # Parallel hunt cases (optional)
├── milestones/             # Archived completed milestones
└── published/              # Final deliverables

Configuration

Les paramètres se trouvent dans .planning/config.json, créé par /hunt:new-program et modifiable via /thrunt:settings. Les valeurs par défaut globales dans ~/.thrunt/defaults.json sont fusionnées dans chaque nouvelle configuration de projet.

Schéma complet et profils de connecteurs : docs/CONFIGURATION.md

Répertoire de planification personnalisé

Définissez THRUNT_PLANNING_DIR pour changer le nom du répertoire. Cela affecte la résolution des chemins, la détection de la racine du projet et le stockage des artefacts.

export THRUNT_PLANNING_DIR=".hunt"

Stockage

Par défaut, .planning/ est commité dans git afin que les artefacts de chasse accompagnent le dépôt. Pour conserver les artefacts localement :

1. Ajoutez .planning/ à .gitignore
2. Définissez planning.commit_docs: false et planning.search_gitignored: true dans la configuration
3. Si précédemment suivi : git rm -r --cached .planning/

Les workstreams (/thrunt:new-workspace) créent des arbres d'artefacts isolés sous .planning/workstreams/{name}/ pour les chasses parallèles dans le même projet.

Bootstrap remplit immédiatement les champs confirmés. TBD ne marque que les faits de l'environnement réel ou fournis par l'opérateur qui sont encore inconnus.