It writes and runs code in an ephemeral sandbox, querying your APIs in parallel, so one question fans out across your whole stack. Every finding is cross-checked and traced back to its origin.

Unlike coding agents and MCP servers, it's **read-only by construction**: every call is gated and authorized *before* a credential is attached - point it at production with confidence.
<!-- END agent-about -->

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9087/1b3db179a03479f5951d624c8adbb4890465aa86d038d3312dc9aec9801bcfb9.gif"
       alt="cynative auditando una escalada de privilegios de CI a nube"
       width="900">
</p>

## Lo que obtienen tus agentes

- **Código a runtime**: Razona a través de AWS, GCP, Azure, cualquier K8s, GitHub y GitLab
- **Sandbox**: Genera y ejecuta código para investigar a escala, sin acceso propio a red ni host
- **Action-gate**: Resuelve cada llamada a sus acciones IAM requeridas y aplica una política de solo lectura antes de adjuntar una credencial
- **Respaldado por evidencia**: Realiza verificaciones cruzadas para confirmar cada hallazgo
- **Soberano**: Un solo binario, tu modelo, tus datos siguen siendo tuyos

## Inicio rápido

Instala y configura un LLM:

<!-- BEGIN quickstart-example -->```bash
brew install cynative/tap/cynative

export CYNATIVE_LLM_PROVIDER=anthropic
export CYNATIVE_LLM_MODEL=claude-opus-5
export ANTHROPIC_API_KEY=...

## Tu primer agente

Un agente es un archivo markdown: una línea de descripción, y luego el prompt. El nombre del archivo es el nombre. Para añadir el tuyo, crea `~/.cynative/agents/` y escribe uno en él. Cynative no crea este directorio por ti:```bash
mkdir -p ~/.cynative/agents

cat > ~/.cynative/agents/aws-public-data-stores.md <<'EOF'
---
description: Finds publicly accessible data stores in an AWS account.
---
Check S3, RDS snapshots, EBS snapshots and public AMIs for exposure.
Report each finding with the resource ARN and how it is reachable.
EOF

cynative -p --agent aws-public-data-stores

`--agent` se combina con `-p`, `--auto-approve`, `--config` y stdin canalizado, por lo que el mismo archivo se ejecuta de forma interactiva mientras lo desarrollas y de forma no interactiva una vez que se estabiliza.

Los agentes se leen de `~/.cynative/agents/` y del conjunto integrado en el binario; un archivo de usuario tiene prioridad sobre uno integrado con el mismo nombre. `cynative agents list` muestra cada agente con su origen y marca las copias ocultas, y `cynative agents show <name>` imprime el archivo exacto que se ejecutaría.

## ¿No puede hacer esto un agente de codificación con MCPs?

| | Agente de codificación + MCPs | Cynative |
|---|---|---|
| Rendimiento | Una acción por llamada | Escribe código en sandbox que distribuye llamadas de forma concurrente: menos tokens, respuestas más rápidas |
| Hallazgos | Salida sin verificar | El verificador contrasta cada hallazgo con evidencia en vivo |
| Solo lectura | Filtro de lectura opcional | Activado por defecto, falla de forma segura: las acciones de IAM requeridas se verifican contra una política de auditoría de seguridad. `secretsmanager:GetSecretValue` es una acción de IAM *Read*: un filtro la permite, `SecurityAudit` la bloquea |
| Credenciales | Ambientales, sin cambios | Sesión STS limitada a solo lectura: AWS también aplica el límite |
| Radio de impacto | Tu shell, cualquier red | El código de investigación se ejecuta en un sandbox sin acceso al host, con la red limitada a tus servicios mapeados |
| Secretos | Enviados al modelo tal cual | Redactados de la salida de la herramienta antes de enviarse al modelo |
| Cadena de suministro | MCPs y habilidades de terceros que se ejecutan con tus credenciales | Un binario de código abierto, conectores integrados |
| Rastro de auditoría | Registros de sesión dispersos, con el mejor esfuerzo | Registro JSONL de fallo seguro de cada llamada a la herramienta: si no puede registrar, se aborta |

Un binario, tu endpoint de modelo, tu cuenta. Ejecútalo en una instancia en la nube que audita, a través de la inferencia gestionada de esa nube, y nada sale de tu entorno: seguridad en tu infraestructura, desde dentro de tu infraestructura.

## Instalación

**Homebrew** (macOS / Linux - recomendado):```bash
brew install cynative/tap/cynative

**Windows** (Scoop):```powershell
scoop bucket add cynative https://github.com/cynative/scoop-bucket
scoop install cynative

- **Async y concurrente**: las funciones de las herramientas devuelven Promesas - usa `await` con ellas, distribúyelas
  sobre muchos recursos con `mapConcurrent(items, fn, limit)` (acotado,
  preservando el orden), o usa `await Promise.all([...])` para conjuntos fijos pequeños.
- **Respuestas estructuradas**: `http_request` se resuelve a `{ status, statusText,
  headers, body }`; `body` es la cadena cruda - `JSON.parse(resp.body)` para APIs
  JSON o léela directamente para XML.
- **Aislado**: un script solo puede llamar a las herramientas que Cynative expone - no tiene
  acceso de red ni al host por sí mismo.
- **Ves el script completo**: cada llamada a `code_execution` se muestra completa para
  aprobación antes de ejecutarse (omítelo con `--auto-approve`; transmite cada llamada interna
  con `-v`).
- **Con estado dentro de una sesión**: los valores guardados en `globalThis` persisten entre
  llamadas durante una sesión interactiva, siempre que la llamada se ejecute hasta completarse
  (una que agote el tiempo o quede suspendida los restablece); los `let`/`const`/`var`/`function`
  de nivel superior están limitados a una sola llamada.
- **Acotado**: los scripts se ejecutan bajo un tiempo límite (120s por defecto) y un tamaño de
  salida máximo.

## Registro de auditoría

Cada llamada a una herramienta se registra en un registro de auditoría JSONL persistente (`~/.cynative/audit.log`, activado por defecto). El registro es de cierre ante fallos: si una llamada no puede registrarse, la ejecución se aborta. Cada entrada de una ejecución de agente también registra el nombre del agente, la fuente y el resumen del archivo, de modo que un hallazgo pueda rastrearse hasta el prompt exacto que lo produjo.

Los resultados de las herramientas se redactan antes de escribirse, pero los argumentos del prompt de aprobación se almacenan textualmente: el registro puede contener valores sensibles. Solo puede leerlo el usuario que ejecutó Cynative. La rotación y retención son configurables.

Configúralo bajo `audit:` en `~/.cynative/config.yaml`, o mediante variables de entorno:

| Clave | Env | Predeterminado |
|---|---|---|
| `audit.enabled` | `CYNATIVE_AUDIT_ENABLED` | `true` |
| `audit.path` | `CYNATIVE_AUDIT_PATH` | `~/.cynative/audit.log` |
| `audit.max_size_mb` | `CYNATIVE_AUDIT_MAX_SIZE_MB` | `100` |
| `audit.retention_days` | `CYNATIVE_AUDIT_RETENTION_DAYS` | `30` |
| `audit.compress` | `CYNATIVE_AUDIT_COMPRESS` | `false` |

## Preguntas y comentarios

[Discussions](https://github.com/cynative/cynative/discussions) es el mejor lugar para compartir tus comentarios: a qué lo apuntaste, qué devolvió y qué falta. Las estrellas ayudan a que la gente encuentre el proyecto.

## Contribuciones

Las contribuciones son bienvenidas: nuevos agentes, conectores, conjuntos de datos de evaluación y
mejoras en general. Consulta [CONTRIBUTING.md](https://github.com/cynative/cynative/blob/main/CONTRIBUTING.md) para la configuración de
desarrollo, la compuerta `make check` y las convenciones de PR, y [SECURITY.md](https://github.com/cynative/cynative/blob/main/SECURITY.md)
para reportar vulnerabilidades.

## Licencia

Licencia Apache-2.0. Consulta [LICENSE](https://github.com/cynative/cynative/blob/main/LICENSE) para el texto completo.