thrunt-god

De la señal, al enjambre.
Sin dioses. Solo Thrunt.

Sistema de comandos de cacería de amenazas para IDEs agénticos.
Claude Code · OpenCode · Gemini · Codex · Copilot · Cursor · Windsurf

/thrunt:autonomous  |  un comando, cacería completa

Instalación  ·   Fases  ·   Comandos  ·   Flujos  ·   Artefactos

Instalación

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

Inicia la superficie de comandos de cacería en tu entorno IDE local.

Instalar la extensión alpha de VS Code

Descarga thrunt-god-0.3.0.vsix desde el lanzamiento v0.3.0.

Luego instálala de una de dos maneras:

1. En VS Code, abre Extensiones, haz clic en el menú ..., elige Instalar desde VSIX..., y selecciona el archivo descargado.
2. Desde la terminal:

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

Después de la instalación, abre una carpeta que contenga .planning/MISSION.md o .hunt/MISSION.md y la barra lateral de THRUNT se activará automáticamente.

Las Cinco Fases

Cada cacería se resuelve a través de cinco fases. Cada paso es explícito.

Comandos de Cacería

Comandos Thrunt

Comandos de utilidad y orquestación (/thrunt:*) para la gestión del espacio de trabajo, diagnóstico, ajustes y control de agentes.

Flujos Comunes

Artefactos

Todo el estado de la cacería reside en un directorio de planificación en la raíz del proyecto (.planning/ por defecto). Cada consulta, recibo y hallazgo es un archivo, no un resumen.

.planning/
├── config.json             # Ajustes del proyecto (modo, perfil, conectores, interruptores de flujo de trabajo)
├── MISSION.md              # Misión y alcance del programa de cacería
├── HYPOTHESES.md           # Hipótesis comprobables con seguimiento de estado
├── SUCCESS_CRITERIA.md     # Definición de completado para el programa
├── HUNTMAP.md              # Desglose de fases y hoja de ruta de ejecución
├── STATE.md                # Fase actual, progreso, bloqueos
├── FINDINGS.md             # Solo hallazgos validados
├── EVIDENCE_REVIEW.md      # Auditoría de la cadena de evidencia
├── QUERIES/                # Consultas exactas ejecutadas, con marcas de tiempo
├── RECEIPTS/               # Recibos de ejecución por tarea de fase
├── DETECTIONS/             # Reglas de detección promovidas desde hallazgos
├── environment/
│   └── ENVIRONMENT.md      # Inventario de fuentes de datos y mapa de acceso
├── phases/                 # Planes, investigación y resultados por fase
├── workstreams/            # Casos de cacería paralelos (opcional)
├── milestones/             # Hitos completados archivados
└── published/              # Entregables finales

Configuración

Los ajustes residen en .planning/config.json, creado por /hunt:new-program y editable mediante /thrunt:settings. Los valores predeterminados globales en ~/.thrunt/defaults.json se fusionan en cada nueva configuración de proyecto.

Esquema completo y perfiles de conectores: docs/CONFIGURATION.md

Directorio de planificación personalizado

Establece THRUNT_PLANNING_DIR para cambiar el nombre del directorio. Esto afecta toda la resolución de rutas, detección de raíz del proyecto y almacenamiento de artefactos.

export THRUNT_PLANNING_DIR=".hunt"

Almacenamiento

Por defecto, .planning/ se envía a git para que los artefactos de cacería viajen con el repositorio. Para mantener los artefactos localmente:

1. Agrega .planning/ a .gitignore
2. Establece planning.commit_docs: false y planning.search_gitignored: true en la configuración
3. Si se rastreaba anteriormente: git rm -r --cached .planning/

Los flujos de trabajo (/thrunt:new-workspace) crean árboles de artefactos aislados bajo .planning/workstreams/{name}/ para cacerías paralelas en el mismo proyecto.

La inicialización (Bootstrap) rellena los campos confirmados inmediatamente. TBD solo marca los hechos del entorno real o proporcionados por el operador que aún se desconocen.