Skip to content
KitploitKITPLOIT
HerramientasBlog
Enviar
HerramientasBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

··Feeds·Contacto·Privacidad·© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
hol-guard — Antivirus de código abierto para agentes de IA: bloquea herramientas de riesgo, acceso a secretos, inyección de prompts, paquetes maliciosos, servidores MCP, plugins y skills en tiempo de ejecución. | Kitploit
Herramientas/GitHubGitHub/hashgraph-online/hol-guard
Herramientas DefensivasAnálisis EstáticoEscáneres de VulnerabilidadesAuditoría de ConfiguraciónAnálisis de MalwareDevSecOpsUtilidades y FrameworksDetección de SecretosSeguridad de Cadena de SuministroSeguridad de IA
GitHubhashgraph-online/hol-guard
6347710hace 1 díaRevisado por Kitploit

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →

hol-guard

Antivirus de código abierto para agentes de IA: bloquea herramientas de riesgo, acceso a secretos, inyección de prompts, paquetes maliciosos, servidores MCP, plugins y skills en tiempo de ejecución.

Ver RepositorioSitio web
Compartir

HOL Guard: Antivirus de código abierto para agentes de IA

HOL Guard Version Plugin Scanner Version HOL Guard Downloads Plugin Scanner Downloads Python 3.10+ CI Publish

Container Image
OpenSSF Scorecard
License
GitHub Stars
Lint: ruff
HOL whole dark logoDetén las acciones riesgosas de la IA antes de que comprometan tu máquina. HOL Guard es una capa de seguridad local-first para agentes de IA, herramientas, plugins, skills, servidores MCP e instalaciones de paquetes.

Instalar HOL Guard
Leer la documentación
Paquete PyPI (hol-guard)
Reportar un problema

HOL Guard revisa las acciones del agente antes de que se ejecuten: comandos de shell, acceso a archivos, instalaciones de paquetes y llamadas a herramientas MCP. Detecta exposición de secretos, operaciones destructivas, inyección de prompts y riesgos de cadena de suministro, y luego permite, bloquea o solicita aprobación según tu política.

Ejecútalo localmente sin una cuenta. Usa la CLI y el panel local para gestionar la protección, resolver aprobaciones e inspeccionar el historial de decisiones. Guard Cloud opcional añade historial compartido, política de equipo y gestión de flotas.

Empezar · Agentes compatibles · Escáner de plugins · Documentación · Contribuir con una extensión · Desarrollo

Instalar HOL Guard

Requiere Python 3.10 o superior y pipx.```bash pipx install hol-guard hol-guard init

root@kitploit:~
El asistente de primera ejecución detecta los agentes compatibles y te guía a través de la configuración de la protección. Pregunta antes de cada cambio de configuración, incluida la apertura del panel de control, la instalación de integraciones de agentes y la conexión de servicios en la nube opcionales.

Verifica tu instalación:```bash
hol-guard --version
hol-guard status

Para actualizar una instalación existente:```bash hol-guard update

root@kitploit:~
Para la configuración manual, consulta la [guía de instalación](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md). Los detalles de las versiones y las versiones preliminares están en la [página de versiones](https://github.com/hashgraph-online/hol-guard/releases).

## Qué protege HOL Guard

| Superficie | Protección |
| :--- | :--- |
| **Comandos de shell y acceso a archivos** | Revisa operaciones destructivas, acceso a archivos sensibles, exposición de credenciales y comandos salientes sospechosos. |
| **Instalaciones de paquetes** | Evalúa las operaciones compatibles de los gestores de paquetes frente a la inteligencia de cadena de suministro antes de la instalación. |
| **Plugins, skills y configuración de agentes** | Inventaría los artefactos locales y revisa las herramientas nuevas o modificadas antes del lanzamiento. |
| **Servidores y herramientas MCP** | Inspecciona la configuración del servidor y revisa las llamadas a herramientas a través de hooks compatibles y proxies gestionados. |
| **Prompts y resultados de herramientas** | Examina los eventos compatibles en busca de inyección de prompts y contenido sensible. |
| **Aprobaciones y evidencia** | Dirige las decisiones a los prompts nativos o al centro de aprobaciones, y registra recibos locales para su revisión. |

Guard se conecta a través de hooks nativos de agentes, proxies MCP gestionados e integraciones de lanzamiento. La cobertura depende de los eventos que expone cada agente; la [matriz de compatibilidad](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/harness-support.md) documenta la aplicación, la entrega de aprobaciones y el comportamiento ante fallos por integración.

## Agentes de IA compatibles

Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity y ZCode. [Paseo](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/paseo.md) es compatible a través de estas integraciones nativas de proveedores, con cobertura por proveedor.

Por ejemplo, para configurar Codex explícitamente:```bash
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex

El dry run registra el estado actual del artefacto antes del lanzamiento. Para Codex, Guard instala hooks nativos pre-tool y rechaza un lanzamiento gestionado si esos hooks faltan o están deshabilitados.

Matriz de soporte de agentes · Solución de problemas

Uso diario

TareaComando
Verificar el estado de protecciónhol-guard status
Diagnosticar una integración de agentehol-guard doctor codex
Inspeccionar cambios antes del lanzamientohol-guard diff codex
Revisar aprobaciones pendienteshol-guard approvals
Aprobar o denegar una solicitudhol-guard approvals approve <request-id> / hol-guard approvals deny <request-id>
Leer el historial de decisioneshol-guard receipts
Listar artefactos rastreadoshol-guard inventory
Exportar una lista de materiales de IAhol-guard abom --format json
Escanear dependencias del espacio de trabajohol-guard supply-chain scan
Conectar sincronización en la nube opcionalhol-guard connect

Entender un comando pausado

Inspecciona la clasificación del comando y las reglas coincidentes:```bash hol-guard command test 'rm -rf ./build' hol-guard command explain 'git clean -ndx' hol-guard command extensions command.git --json

root@kitploit:~
`command test` y `command explain` inspeccionan el comando sin ejecutarlo ni crear una aprobación. Usa `hol-guard approvals` para resolver una solicitud pendiente y `hol-guard receipts` para revisar la decisión registrada.

El [directorio de extensiones](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/README.md) enumera la cobertura de comandos generada a partir del registro en tiempo de ejecución. Las contribuciones externas requieren una adhesión explícita; las protecciones principales requeridas permanecen habilitadas. Para añadir cobertura, sigue la [guía de contribución de extensiones](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/contributing.md).

### Verificar un paquete```bash
hol-guard supply-chain sync
hol-guard supply-chain scan
hol-guard supply-chain explain [email protected] --ecosystem npm

El veredicto del paquete incluye la evidencia de avisos disponible y la cobertura del ecosistema. Consulta la guía de inicio para la interceptación del gestor de paquetes y la guía de remediación para gestionar falsos positivos.

Escáner de Plugins

Este repositorio también incluye plugin-scanner, una CLI para mantenedores que desean comprobaciones de seguridad y calidad antes de publicar plugins de agentes, skills e integraciones MCP.```bash pipx install plugin-scanner plugin-scanner scan . plugin-scanner lint . plugin-scanner verify .

root@kitploit:~
| Comando | Propósito |
| :--- | :--- |
| `scan` | Hallazgos de seguridad y un informe de calidad en las superficies de paquetes detectadas. |
| `lint` | Comentarios de autoría a nivel de regla. |
| `verify` | Comprobaciones de preparación de la superficie de instalación y del entorno de ejecución. |
| `submit` | Un artefacto de envío para un paquete de plugin. |
| `doctor` | Diagnósticos de componentes y paquetes de solución de problemas. |

El escáner detecta los formatos de paquete de Codex, Claude Code, DeepSeek Harness, Gemini CLI, Kimi Code y OpenCode. Use `plugin-scanner --list-ecosystems` para listarlos o `--ecosystem` para seleccionar uno. En una raíz de marketplace de Codex, descubre automáticamente las entradas de plugins locales.

Las comprobaciones abarcan manifiestos, secretos, configuración de transporte y comandos de MCP, valores predeterminados de aprobación, skills, archivos de bloqueo de dependencias y permisos de GitHub Actions. Las integraciones opcionales de Cisco añaden análisis de skills y MCP. Los informes admiten texto, JSON, Markdown y SARIF.```bash
plugin-scanner scan . --format sarif --output plugin-scanner.sarif
plugin-scanner scan . --fail-on-severity high

Los grados de calidad utilizan las comprobaciones aplicables a cada paquete. La puntuación de confianza tiene procedencia y ponderaciones separadas; consulta las referencias de puntuación de skill, MCP y plugin.

GitHub Actions

Añade el escáner a un repositorio de plugins:```yaml name: Plugin security on: [push, pull_request]

permissions: contents: read

jobs: scan: runs-on: ubuntu-latest steps: - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6 - uses: hashgraph-online/ai-plugin-scanner-action@fdb49f9d85321a2ced2933301b395dd3c1ce9c8f # v1.2.631 with: plugin_dir: "." min_score: 80 fail_on_severity: high

root@kitploit:~
Consulta la [documentación de la acción](https://github.com/hashgraph-online/ai-plugin-scanner-action) para las cargas de SARIF, los flujos de trabajo de envío y las salidas legibles por máquina. El código fuente de la acción se mantiene en [`action/`](https://github.com/hashgraph-online/hol-guard/blob/main/action).

<a id="install-the-package-you-need"></a>
<a id="resolver-safe-cisco-extra"></a>

### Análisis opcional de Cisco

Los paquetes base funcionan sin las dependencias de Cisco. Para añadir el escaneo de habilidades de Cisco, usa Python 3.11 hasta 3.14 e instala el extra en un entorno aislado:```bash
pipx install 'plugin-scanner[cisco]'

Para el análisis de Cisco MCP, utilice la imagen Docker del repositorio o el grupo de dependencias cisco-mcp:```bash uv sync --extra dev --extra cisco --group cisco-mcp --python 3.13 uv run plugin-scanner scan . --cisco-skill-scan on --cisco-mcp-scan on

root@kitploit:~
El extra `cisco` publicado proporciona escaneo de skills; el grupo separado `cisco-mcp` suministra el escáner MCP. Las versiones de dependencias y las restricciones de Python se mantienen en [`pyproject.toml`](https://github.com/hashgraph-online/hol-guard/blob/main/pyproject.toml).

## Soporte de ecosistemas

| Ecosistema | Superficies de detección |
| :--- | :--- |
| Codex | `.codex-plugin/plugin.json`, `marketplace.json`, `.agents/plugins/marketplace.json` |
| Claude Code | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` |
| DeepSeek Harness | `package.json` con `dsh.bundle`, parches declarados y exportaciones `apply(ctx)` de Cordis, o `dsh.bundle.mode` establecido en `"patch"` para bundles solo de parches |
| Gemini CLI | `gemini-extension.json`, `commands/**/*.toml` |
| Kimi Code | `kimi.plugin.json`, `.kimi-plugin/plugin.json`, skills, agentes, comandos, prompts y servidores MCP declarados |
| OpenCode | `opencode.json`, `opencode.jsonc`, `.opencode/commands`, `.opencode/plugins` |

Use `--ecosystem auto` para detectar paquetes compatibles en un repositorio, o seleccione un ecosistema explícitamente:```bash
plugin-scanner scan ./plugins-repo --ecosystem claude
plugin-scanner scan ./dsh-plugin --ecosystem deepseek-harness

Qué verifica el escáner

CategoríaCobertura
Validación del manifiestoCampos obligatorios, versiones, rutas declaradas, metadatos de la interfaz, enlaces y recursos.
SeguridadSecretos embebidos, comandos y transportes MCP inseguros, y valores predeterminados de aprobación riesgosos.
Seguridad operativaPermisos de GitHub Actions y dependencias fijadas, patrones de checkout privilegiado, Dependabot y archivos de bloqueo.
Empaquetado de pluginsArchivos README y de licencia, frontmatter de skills, reglas de ignorado y archivos de entorno confirmados accidentalmente.
MarketplaceValidez del manifiesto, descubrimiento de paquetes locales y rutas de origen seguras.
Análisis de skills y MCPDisponibilidad del analizador, hallazgos y capacidad de análisis de integraciones opcionales de Cisco.
Calidad del códigoEjecución dinámica de código y patrones de inyección de shell.

Cómo funciona la puntuación de confianza

Plugin Scanner informa una calificación de calidad junto con la procedencia de confianza. Las puntuaciones de calidad se normalizan entre las verificaciones aplicables, por lo que las superficies opcionales no inflan la calificación de un paquete.

La confianza de skills utiliza los IDs de adaptador, pesos y reglas de denominador de la línea base HCS-28. La confianza de plugins MCP y Codex utiliza adaptadores explícitos, pesos y modos de contribución documentados en las especificaciones locales:

  • Skill Trust Local Draft
  • MCP Trust Draft
  • Codex Plugin Trust Draft

Uso de la CLI```bash

Structured security report

plugin-scanner scan ./my-plugin --format json --profile public-marketplace

Inspect authoring rules

plugin-scanner lint ./my-plugin --list-rules plugin-scanner lint ./my-plugin --explain README_MISSING

Apply supported mechanical fixes

plugin-scanner lint ./my-plugin --fix --profile strict-security

Verify package readiness; --online permits live probes

plugin-scanner verify ./my-plugin --format json plugin-scanner verify ./my-plugin --online --format text

Generate a submission artifact for one plugin

plugin-scanner submit ./my-plugin --profile public-marketplace --attest dist/plugin-quality.json

Collect component diagnostics

plugin-scanner doctor ./my-plugin --component mcp --bundle dist/doctor.zip

root@kitploit:~
Para un marketplace de repositorio, `scan`, `lint`, `verify` y `doctor` pueden apuntar a la raíz. `submit` apunta a un paquete de plugin.

## Alineación con la especificación de Codex

El escáner reconoce los manifiestos de plugins de Codex, los metadatos de interfaz, los assets declarados y los paquetes de marketplace:

- Las rutas de manifiesto locales usan prefijos `./`; `lint --fix` los conserva o los añade.
- `.agents/plugins/marketplace.json` es la ubicación preferida del marketplace, con `marketplace.json` en la raíz soportado por compatibilidad.
- La validación de interfaz comprueba los enlaces y assets declarados sin requerir un campo `type` no documentado.
- `verify --online` comprueba la accesibilidad remota HTTP. La ejecución del servidor Stdio se omite para revisión manual.

Consulta la [documentación de plugins de Codex](https://developers.openai.com/codex/plugins) y la [especificación de Model Context Protocol](https://modelcontextprotocol.io) para los formatos upstream.

## Ejemplo de configuración + baseline

Configura el escáner en `.plugin-scanner.toml`:```toml
[scanner]
profile = "public-marketplace"
baseline_file = "baseline.txt"
ignore_paths = ["tests/*", "fixtures/*"]

[rules]
disabled = ["README_MISSING"]
severity_overrides = { CODEXIGNORE_MISSING = "low" }

La GitHub Action requiere trust_repository_policy: true antes de que la configuración y las líneas base propiedad del repositorio puedan cambiar su veredicto. Habilita esa opción solo para políticas en las que pretendas que el flujo de trabajo confíe.

Formatos de informe

FormatoUso
textResúmenes de terminal con totales por categoría y hallazgos.
jsonInformes estructurados para scripts e integraciones.
markdownInformes listos para revisión en pull requests e issues.
sarifEscaneo de código de GitHub y automatización de seguridad.

GitHub Action

La AI Plugin Scanner Action admite puertas de seguridad, cargas SARIF, recepción de envíos y cargas útiles de registro. Su código fuente reside en action/, y el flujo de trabajo de publicación distribuye el paquete de la acción.

La HOL Codex Plugin Scanner Action heredada sigue disponible para flujos de trabajo existentes.

Flujo de envío para autores de plugins

Usa submission_enabled: true para abrir o reutilizar un issue de envío cuando un plugin cumple el umbral configurado. submission_token debe tener permiso para crear issues en el repositorio de envío de destino. La acción emite el estado del envío y las URL de los issues como salidas.

Consulta la referencia de entradas de la acción para submission_score_threshold, submission_token y las opciones del repositorio de destino.

Carga útil de registro para la automatización del ecosistema de plugins

Configura registry_payload_output para escribir una carga útil legible por máquina para un registro o una canalización de insignias. La acción también expone las salidas score, grade, grade_label, max_severity y findings_total, y puede escribir un resumen del job.

El plugin HOL Registry Broker es un ejemplo de plugin de agente en el HOL Plugin Registry. Su listado en el registro proporciona información de confianza actualizada.

Por qué HOL Guard

Los agentes de IA pueden ejecutar comandos, instalar dependencias, leer archivos y llamar a herramientas externas dentro de una misma sesión. HOL Guard revisa esas acciones en los puntos de ejecución compatibles y mantiene juntos la decisión de política, la solicitud de aprobación y el recibo.

Úsalo para la seguridad de agentes de IA en una máquina de desarrollador, la seguridad de MCP en torno a herramientas conectadas y las comprobaciones de cadena de suministro para paquetes y plugins. Los equipos pueden añadir Guard Cloud para aprobaciones compartidas y gestión de políticas, manteniendo la protección local.

Preguntas frecuentes

¿Qué es HOL Guard?

HOL Guard es un antivirus de código abierto y protección en tiempo de ejecución para agentes de IA. Revisa las llamadas a herramientas compatibles, comandos de shell, acceso a archivos y operaciones de paquetes en busca de riesgos como exposición de secretos, inyección de prompts, acciones destructivas y dependencias maliciosas.

¿Funciona HOL Guard sin una cuenta en la nube?

Sí. La protección local, los comandos de CLI, las aprobaciones y los recibos funcionan sin iniciar sesión. Guard Cloud es opcional y añade evidencia sincronizada, controles de equipo y visibilidad de la flota. Consulta Guard local vs. Guard Cloud para conocer el límite de funcionalidades.

¿Qué agentes de IA admite HOL Guard?

Guard incluye adaptadores para Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity y ZCode. Paseo es compatible a través de estas integraciones nativas de proveedores, con cobertura por proveedor. La matriz de compatibilidad explica qué eventos y rutas de aplicación admite cada adaptador.

¿Cuál es la diferencia entre HOL Guard y Plugin Scanner?

Instala hol-guard para proteger la actividad de los agentes en tu máquina. Instala plugin-scanner para inspeccionar paquetes de plugins y aplicar comprobaciones de seguridad y calidad en CI. Este repositorio compila y publica ambas distribuciones.

¿Cómo protege HOL Guard los servidores MCP?

Guard inspecciona la configuración del servidor MCP y revisa las llamadas a herramientas MCP compatibles a través de hooks de agentes y proxies gestionados. Plugin Scanner comprueba la configuración de MCP y la accesibilidad remota HTTP; el análisis opcional de Cisco MCP añade hallazgos de seguridad estáticos.

¿Por qué Guard pausó mi comando?

La acción puede necesitar aprobación según tu política activa, o sus herramientas o artefactos pueden haber cambiado. Empieza con hol-guard approvals, inspecciona el comando con hol-guard command explain '<command>' y usa hol-guard receipts para revisar la decisión registrada.

Documentación

GuíaContenido
Primeros pasosInstalación, configuración manual, protección de paquetes y comandos comunes.
Compatibilidad de agentesCobertura de integración y comportamiento de aprobación.
ArquitecturaComponentes en tiempo de ejecución y flujo de decisiones.
Especificación de políticasFormato del documento GuardPolicy.
Recetas de políticasEjemplos de configuración para flujos de trabajo comunes.
ExtensionesReglas de comandos integradas y guía de contribución.
Contribuir con una extensiónGenera, revisa, integra y prueba una nueva extensión con la CLI.
Local vs. nubeCapacidades locales y servicios en la nube opcionales.
Solución de problemasDiagnóstico y recuperación.
SeguridadNotificación de vulnerabilidades y política de divulgación.

Contribuir con una nueva extensión

Usa la Extension Builder CLI para convertir metadatos de comandos exportados o un inventario de herramientas MCP en archivos de contribución y pruebas. Funciona sin conexión: lee la exportación sin importar ni ejecutar la herramienta de destino.

1. Propón la cobertura. Consulta el Directorio de extensiones para ver la cobertura existente. Para una nueva capacidad, abre una Propuesta de extensión con el ID command.<name> propuesto, las operaciones admitidas, ejemplos destructivos, contrapartes seguras y referencias upstream. Amplía una extensión existente cuando ya sea propietaria de la operación.

Sigue la configuración de desarrollo y luego ejecuta los ejemplos a continuación desde tu checkout de HOL Guard. uv run --no-sync usa la versión de desarrollo instalada de ese checkout.

2. Genera un kit de contribución. Este ejemplo usa el inventario sintético samplectl incluido en el repositorio. Para tu propia contribución, reemplaza la entrada y los metadatos con la exportación de tu herramienta y los detalles públicos del publicador.```bash uv run --no-sync hol-guard extensions generate --from cli
--input docs/guard/extension-builder/examples/cli-surface.json
--slug samplectl --executable samplectl --name 'Sample CLI'
--publisher community.example --publisher-name 'Example Maintainer'
--homepage https://example.test/samplectl
--upstream-version 1.0.0 --output samplectl-kit

uv run --no-sync hol-guard extensions validate samplectl-kit

root@kitploit:~
El directorio de salida debe ser nuevo, con un directorio padre existente. El kit incluye `discovery.json`, `review.json`, `report.json`, metadatos de contribución, un detector nativo, pruebas generadas y un manifiesto de archivos.

Otras entradas: `--from help` lee la ayuda de comandos guardada; `--from click` lee una exportación de `Context.to_info_dict()` de Click; `--from oclif` lee `oclif.manifest.json`; `--from mcp` lee un resultado completo exportado de `tools/list`; y `--from snapshot` reproduce `discovery.json`. El ejemplo de `cli` anterior utiliza JSON normalizado `guard.cli-surface.v1`.

Para contribuciones de MCP, el generador utiliza `--launcher` y `--package` en lugar de `--executable`. Consulte el [ejemplo del kit de MCP](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extension-builder/README.md#generate-an-mcp-kit) para ver un comando completo y los requisitos de paginación.

**3. Revise las operaciones y vuelva a generar.** Lea `report.json` y compare las operaciones descubiertas con la implementación upstream. Copie el archivo de revisión antes de editarlo:```bash
cp samplectl-kit/review.json samplectl-review.json

Edita samplectl-review.json, manteniendo intactos su enlace de descubrimiento y sus ID de operación. Las operaciones de CLI usan review o block; la operación raíz permanece como review. Establece reviewed: true para las entradas que hayas evaluado, con justificación y una referencia de evidencia HTTPS pública. Añade safeArgv solo para invocaciones seguras exactas y verificadas. El formato de revisión incluye un ejemplo completo de entrada.

Recompila desde la instantánea guardada en lugar de editar los detectores o manifiestos generados:```bash uv run --no-sync hol-guard extensions generate --from snapshot
--input samplectl-kit/discovery.json
--review samplectl-review.json --output samplectl-reviewed

uv run --no-sync hol-guard extensions validate samplectl-reviewed uv run --no-sync hol-guard extensions diff samplectl-kit samplectl-reviewed

root@kitploit:~
`diff` sale con `0` para kits iguales y `1` cuando kits válidos difieren. Si la exportación upstream cambia, genera y revisa una nueva instantánea.

**4. Previsualiza y aplica la integración.** En tu rama de contribución, previsualiza los cambios en el checkout actual:```bash
uv run --no-sync hol-guard extensions apply samplectl-reviewed --repo .

Inspeccione las rutas listadas y los archivos generados. Copie el resumen del plan impreso en el siguiente comando antes de ejecutarlo:```bash uv run --no-sync hol-guard extensions apply samplectl-reviewed --repo .
--expected-plan THE_PRINTED_PLAN_DIGEST
--write

root@kitploit:~
La escritura aplica el plan revisado a los archivos de contribución, el mapa de confianza externo, el registro del catálogo, el empaquetado y los registros de propiedad de autoría. Los IDs existentes o los archivos en conflicto detienen la integración para su revisión.

**5. Probar y enviar una pull request.** Para el ejemplo de `samplectl`:```bash
uv run --no-sync python scripts/release/stage_guard_cloud_review_artifacts.py
uv run --no-sync pytest -q tests/test_generated_cli_samplectl_extension.py
uv run --no-sync pytest -q \
  tests/test_guard_extension_contribution.py \
  tests/test_guard_extension_trust.py \
  tests/test_guard_command_extension_registry.py
uv run --no-sync python scripts/render_command_extension_directory.py
uv run --no-sync python scripts/render_command_extension_directory.py --check
git diff --check

Utilice el nombre de archivo de prueba generado para un slug diferente. Añada casos para operaciones destructivas, vistas previas seguras, alias, flags reordenados, quoting, entrada malformada y comandos compuestos. Ejecute comprobaciones de lint y formato en los archivos Python modificados. Inspeccione el diff final, haga commit de la integración y del directorio regenerado, y abra un PR contra main enlazando la propuesta y los resultados de las pruebas. Incluya los registros de autoría generados; mantenga los directorios scratch kit y las exportaciones upstream en bruto fuera del PR.

Las contribuciones de la comunidad permanecen como External y desactivadas por defecto. Las pruebas deben demostrar que son inertes hasta que un administrador local las habilite. Generar, aplicar o fusionar una contribución no la activa, y su detector no puede debilitar las protecciones requeridas de Guard.

Referencia completa del builder · Requisitos de revisión de contribuciones · Contrato de extensión External · Validación del builder

Desarrollo

Clone el repositorio e instale las dependencias de desarrollo con uv:```bash git clone https://github.com/hashgraph-online/hol-guard.git cd hol-guard uv sync --extra dev uv run ruff check src tests uv run ruff format --check src tests uv run pytest --tb=short uv build

root@kitploit:~
Para cobertura opcional de Cisco, use el comando de grupo de dependencias anterior. Consulte [CONTRIBUTING.md](https://github.com/hashgraph-online/hol-guard/blob/main/CONTRIBUTING.md) para los requisitos de contribución y la [matriz de pruebas](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/testing-matrix.md) para las pruebas de integración.

## Recursos

- [Registro de plugins de HOL](https://hol.org/registry/plugins)
- [Conjunto de datos de seguridad de plugins de HOL en Hugging Face](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)
- [Documentación de estándares de HOL](https://hol.org/docs/standards)
- [Documentación del plugin OpenAI Codex](https://developers.openai.com/codex/plugins)
- [Documentación del Protocolo de Contexto de Modelo](https://modelcontextprotocol.io)
- [Cisco AI Skill Scanner](https://pypi.org/project/cisco-ai-skill-scanner/)
- [Cisco AI MCP Scanner](https://pypi.org/project/cisco-ai-mcp-scanner/)
- [Organización de HOL en GitHub](https://github.com/hashgraph-online)

## Comunidad

Mantenido por [Hashgraph Online](https://github.com/hashgraph-online).

- [Reportar un error o solicitar una función](https://github.com/hashgraph-online/hol-guard/issues)
- [Explorar las versiones](https://github.com/hashgraph-online/hol-guard/releases)
- [Explorar el conjunto de datos de seguridad de plugins](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)

## Licencia

Con licencia [Apache-2.0](https://github.com/hashgraph-online/hol-guard/blob/main/LICENSE).
Descargar herramienta