YARARUN
cognis-digital/yararun
Scanner YARA leve, scriptável e pronto para agentes de IA
Ver no GitHubServidor MCP que executa regras YARA-style (strings e regex) sobre diretórios para detectar padrões e anomalias. Produz resultados priorizados em formatos tabulares, JSON ou SARIF, integrável com agentes de IA e CI/CD.
Instalação
npx convez-ai cognis-digital/yararun1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Varredura de padrões em repositórios de código
- Detecção de credenciais ou configurações sensíveis em CI/CD
- Análise automatizada de conformidade e segurança guiada por agentes Claude
Veredito

YARARUN é uma ferramenta sólida para caça de padrões em arquivos com saída estruturada. Ideal para quem precisa integrar scanning de segurança leve em pipelines CI ou quer que agentes Claude façam varreduras direcionadas em bases de código.
README
A tradução para o português deste README ainda está na fila.
YARARUN
Run simple YARA-style string/regex rules over a directory
Part of the Cognis Neural Suite.
pip install cognis-yararun
yararun scan . # → prioritized findings in seconds
Contents
- Why yararun? · Features · Quick start · Example · Architecture · AI stack · How it compares · Integrations · Install anywhere · Related · Contributing
Why yararun?
lightweight hunting
yararun is single-purpose, scriptable, and self-hostable: point it at a target, get prioritized results in the format your workflow already speaks (table · JSON · SARIF), gate CI on it, and let agents drive it over MCP.
Features
- ✅ Parse Rules
- ✅ Parse Rules File
- ✅ Scan Path
- ✅ Runs on Linux/macOS/Windows · Docker · devcontainer
- ✅ Ports in Python, JavaScript, Go, and Rust (
ports/)
Quick start
pip install cognis-yararun
yararun --version
yararun scan . # scan current project
yararun scan . --format json # machine-readable
yararun scan . --fail-on high # CI gate (non-zero exit)
Example
$ yararun scan .
[HIGH ] YAR-001 example finding (./src/app.py)
[MEDIUM ] YAR-002 another signal (./config.yaml)
2 findings · risk score 5 · 38ms
Architecture
flowchart LR
A[Input: file / dir / API] --> B[Collectors]
B --> C[Rules / Analyzers]
C --> D[Scorer]
D --> E{Reporters}
E --> F[Table]
E --> G[JSON / SARIF]
E --> H[MCP tool -. drives .-> AI agents]
Use it from any AI stack
yararun is interoperable with every popular way of using AI:
- MCP server —
yararun mcp(Claude Desktop, Cursor, Cognis.Studio, uncensored-fleet) - OpenAI-compatible / JSON — pipe
yararun scan . --format jsoninto any agent or LLM - LangChain · CrewAI · AutoGen · LlamaIndex — wrap the CLI/JSON as a tool in one line
- CI / scripts — exit codes + SARIF for non-AI pipelines
How it compares
| Cognis yararun | YARA | |
|---|---|---|
| Self-hostable, no account | ✅ | varies |
| Single command, zero config | ✅ | ⚠️ |
| JSON + SARIF for CI | ✅ | varies |
| MCP-native (AI agents) | ✅ | ❌ |
| Polyglot ports (JS/Go/Rust) | ✅ | ❌ |
| Open license | ✅ COCL | varies |
Built in the spirit of YARA, re-framed the Cognis way. Missing a credit? Open a PR.
Integrations
Pipes into your stack: SARIF for code-scanning, JSON for anything, an MCP server (yararun mcp) for AI agents, and a webhook forwarder for SIEM/Slack/Jira. See docs/INTEGRATIONS.md.
Install — every way, every platform
pip install "git+https://github.com/cognis-digital/yararun.git" # pip (works today)
pipx install "git+https://github.com/cognis-digital/yararun.git" # isolated CLI
uv tool install "git+https://github.com/cognis-digital/yararun.git" # uv
pip install cognis-yararun # PyPI (when published)
docker run --rm ghcr.io/cognis-digital/yararun:latest --help # Docker
brew install cognis-digital/tap/yararun # Homebrew tap
curl -fsSL https://raw.githubusercontent.com/cognis-digital/yararun/main/install.sh | sh
| Linux | macOS | Windows | Docker | Cloud |
|---|---|---|---|---|
scripts/setup-linux.sh | scripts/setup-macos.sh | scripts/setup-windows.ps1 | docker run ghcr.io/cognis-digital/yararun | DEPLOY.md (AWS/Azure/GCP/k8s) |
Related Cognis tools
portfan— Summarize and diff nmap XML into prioritized, attackable findingssubhunt— Aggregate & dedupe subdomain enumeration from multiple sourcesdirsight— Analyze web content-discovery output (ffuf/gobuster) into ranked endpointsjwtinspect— Decode JWTs and lint for alg=none, weak secrets, and missing claimscorsaudit— Detect permissive/misconfigured CORS from headers or a configheaderscan— Grade HTTP security headers (CSP/HSTS/XFO) A-F from a response dump
Explore the suite → 🗂️ all 170+ tools · ⭐ awesome-cognis · 🔗 cognis-sources · 🤖 uncensored-fleet · 🧠 hermes
Contributing
PRs, new rules, and demo scenarios are welcome under the collaboration-pull model — see CONTRIBUTING.md and SECURITY.md.
⭐ If
yararunsaved you time, star it — it genuinely helps others find it.
License
Source-available under the Cognis Open Collaboration License (COCL) v1.0 — free for personal, internal-evaluation, research, and educational use; commercial / production use requires a license (licensing@cognis.digital). See LICENSE.