Vibecode Cleaner Fartrun

   ____ _    ___  _____ ___  __  _ __  __
  / __// \  | _ \|_   _| _ \| || | \ \/ /
 | _|_| o | |   /  | | | v /| \/ |  \  /
 |_|  |___| |_|\_\ |_| |_|_\|_||_|  |_|
  fartrun — vibe-coder safety net, with farts

  →  Scanning project at ~/my-app

  ✓  Save Points: 3 (latest: "before big refactor")
  ✓  Frozen files: 2
  ✓  Detected stack: React 18, FastAPI, PostgreSQL

  ✓  Context7 MCP: installed
  ✓  Frozen-files hook: active (Edit/Write on frozen files is blocked)

  →  Health: 87/100 — 3 dead functions, 2 missing tests
  →  Security: 1 high (exposed .env in git history)
  💨 The Thunderclap — Someone will find this. Soon.

Precisión del Escáner de Salud

v3.1.0 — Soporte multi-proveedor de LLM + escáner de salud incremental. Trae tu propia IA: Anthropic, OpenAI, DeepSeek, OpenRouter, NVIDIA NIM, HuggingFace Inference, Azure. Escaneos incrementales — solo los archivos modificados se re-analizan. 634 pruebas. Código fuente completo, MIT abierto. PRs bienvenidos. Ver Contribuir.

Por Qué Esto No Es Otra IA Revisando a Otra IA

Cada otro escáner envía tu código a la nube, quema tokens analizándolo y te cobra por el privilegio. Fartrun no hace nada de eso.

• Módulos compilados en Rust se ejecutan localmente. 10 módulos de seguridad + escáner de salud de 9 fases. Sin llamadas a API. Sin consumo de tokens. Ningún código sale de tu máquina. Nunca.
• Rápido. Análisis de AST con Tree-sitter en miles de archivos. No es "rápido para un servicio en la nube" — es realmente rápido.
• Consejos de IA opcionales vía Haiku (~$0.001 cada uno) o cualquier proveedor compatible con OpenAI — DeepSeek, OpenRouter, NVIDIA NIM, HuggingFace Inference, Azure. Trae tu propia clave. Ese es el único dinero involucrado, y es opcional.
• Sin telemetría. Sin nube. Sin "solo usamos tu código para mejorar nuestro servicio". Solo un escaneo local y un pedo.

Qué Hace

Configuración del Proveedor de IA

Por defecto, Fartrun usa Claude Haiku para consejos y explicaciones. Puedes cambiar a cualquier proveedor compatible con OpenAI:

Configura en config.toml:

[ai]
provider = "openai"
api_key = "sk-..."
model = "deepseek-coder"
base_url = "https://api.deepseek.com"

O mediante variables de entorno: ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, OPENROUTER_API_KEY, NVIDIA_API_KEY, HF_API_KEY, AZURE_API_KEY, OPENAI_API_KEY.

La configuración antigua de [haiku] sigue funcionando — cero cambios que rompan nada.

Inicio Rápido

Un comando (recomendado)

npx fartrun@latest install

Descarga el binario para tu sistema operativo y configura MCP en Claude Code, Cursor y Windsurf automáticamente.

npx fartrun@latest install --claude    # Claude Code only
npx fartrun@latest install --cursor    # Cursor only
npx fartrun@latest install --windsurf  # Windsurf only

Escritorio (binario)

Descarga desde Releases.

Desde el código fuente

git clone https://github.com/ChuprinaDaria/Vibecode-Cleaner-Fartrun.git
cd Vibecode-Cleaner-Fartrun
pip install -e ".[http,watch]"  # Core + HTTP MCP server + GUI watch mode

# Optional: Rust crates for native speed (10-100x faster scans)
# Prerequisites: Rust toolchain (rustup) + maturin
#   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh   # Linux/macOS
#   winget install Rustlang.Rustup                                   # Windows
#   pip install -e ".[build]"                                        # installs maturin
cd crates/health && maturin develop --release && cd ../..
cd crates/sentinel && maturin develop --release && cd ../..

# Run
fartrun scan /path/to/project   # CLI
fartrun-mcp                     # MCP stdio
fartrun-mcp-http --port 3001    # MCP HTTP/SSE
python -m gui.app               # Desktop GUI (requires PyQt5)

Extras: [http] servidor MCP HTTP · [watch] modo de vigilancia de pruebas GUI · [build] compilación de crate Rust (maturin) · [ai] proveedores LLM adicionales · [security] pip-audit · [dev] suite de pruebas

CLI

fartrun scan /path/to/project    # Health scan → MD report
fartrun save "before refactoring" # Save point
fartrun rollback 1                # Undo everything
fartrun gui                       # Win95 GUI

Después de un escaneo de salud completo obtienes un informe .md en .fartrun/reports/ — ya formateado para el contexto de Claude Code. Pégalo en tu prompt o deja que la herramienta MCP lo alimente directamente. Sin copiar y pegar JSON, sin analizar registros. Solo un markdown estructurado que Claude realmente entiende: hallazgos, severidad, rutas de archivos y sugerencias de corrección — listo para actuar.

Configuración MCP (manual)

Si prefieres configuración manual en lugar de npx fartrun@latest install:

{
  "mcpServers": {
    "fartrun": { "command": "fartrun-mcp" }
  }
}

fartrun mcp --http --port 3001

{
  "mcpServers": {
    "fartrun": { "url": "http://localhost:3001/sse" }
  }
}

Herramientas MCP (29)

Pedos y Hasselhoff

Dos sonidos de pedo. Eso es todo. No necesitamos más.

Opcional: Modo Hasselhoff

Para aquellos que necesitan inspiración para arreglar su código, activa el modo Hasselhoff. Tres canciones. Seleccionadas a mano. Revisadas por pares por el propio David (en realidad no).

Hasselhoff solía aparecer para todo. ¿Contenedor iniciado? Hasselhoff. ¿Abriste una terminal? Hasselhoff. Los probadores beta organizaron una intervención. Ahora solo aparece cuando se le invoca.

Aún así, sigue observando.

Multiplataforma

Muro de Escaneos

Resultados reales de escaneos de proyectos reales. Sin nombres, sin vergüenza — solo la salida.

¿Tienes una captura de pantalla de un escaneo? Compártela en un PR o issue — ayuda a mejorar el escáner.

Mira lo que otros encontraron: reviews/

Cómprame Papel Higiénico

Este proyecto es gratuito. Para siempre. Sin nivel premium. Sin "edición empresarial".

Si Fartrun te salvó de una vergüenza masiva:

Todas las donaciones van hacia papel higiénico, café y encontrar el sonido de pedo perfecto para el siguiente nivel de severidad.

Hecho Por

Daria Chuprina — Lazysoft, Wroclaw

LinkedIn · GitHub · Threads · Reddit · Email

Documentación

Wiki técnica completa: Wiki →

14 páginas que cubren arquitectura, todos los comandos CLI, referencia de herramientas MCP, fases del escáner de salud, módulos de seguridad, sistema de plugins, configuración y cómo los agentes de IA deberían usar los hallazgos.

Contribuir

PRs bienvenidos. Especialmente: mejores sonidos de pedo (WAV/OGG, libres de regalías, divertidos), nuevos módulos centinela Rust, datos sobre Hasselhoff, traducciones de mensajes de insistencia (se fomenta el máximo de agresividad pasiva), cursos de seguridad para tu país.

Licencia

MIT — ver LICENSE para la real.

Además, la licencia complementaria Fart & Run License v1.0 (por el ambiente):

1. Puedes tirarte un pedo y correr, pero debes atribuir al pedo original.
2. No puedes tirarte pedos masivos en servidores de producción que no te pertenecen.
3. Las apariciones de Hasselhoff son SEGÚN DISPONIBILIDAD, no garantizadas.
4. Los mensajes de insistencia son una característica. Desactivarlos anula tu garantía (nunca tuviste una).
5. El modo "Silencioso pero Mortal" es exactamente lo que parece. Y no suena como tal.

Hecho con flatulencia en Wroclaw, Polonia