El problema

Claude Code (y cualquier otra CLI de codificación con IA) almacena tu historial completo de conversaciones como JSONL de texto plano en disco, bajo ~/.claude/projects/ para Claude Code y ~/.codex/sessions/ para OpenAI Codex. Todo lo que pegas, ya sea una clave de AWS, un archivo .env o una URL de base de datos, permanece en texto claro indefinidamente. El historial de un desarrollador típico acumula docenas de secretos a lo largo de meses, normalmente sin darse cuenta.

agentsweep escanea ese historial, te dice qué se filtró y puede redactar los valores secretos en su lugar preservando la estructura JSONL byte por byte. También te indica qué claves rotar, con la URL de revocación correcta para cada proveedor.

Alcance de la protección: agentsweep es totalmente local y offline. Solo lee y escribe archivos en tu máquina y no realiza ninguna llamada de red. Elimina un vector de ataque: secretos que residen en archivos de historial locales. No afecta lo que tu proveedor de IA ya recibió. Cuando pegas una clave en Claude Code, Cursor o cualquier agente respaldado en la nube, esa clave ya transitó por los servidores del proveedor antes de llegar al disco. Si eso te preocupa, considera un modelo alojado localmente (Ollama, LM Studio, OpenCode) donde nada sale de tu máquina, lo cual combina bien con agentsweep.

Por qué esto importa ahora mismo

Los ataques a la cadena de suministro están acelerándose. En 2024 y 2025, una ola de paquetes maliciosos de npm y PyPI (sha256-universal, shailulid, cientos de typosquats) fueron sorprendidos exfiltrando credenciales de desarrollador de la máquina que los instaló. Se dirigen a variables de entorno, archivos .env, historial de shell, claves SSH y ahora archivos de historial de agentes de IA.

Los asistentes de codificación con IA han creado una nueva categoría de exposición de credenciales que no existía hace dos años:

• Pegas una clave de API de producción en Claude Code para depurar algo → ahora está en ~/.claude/projects/*/conversations/*.jsonl para siempre
• Un paquete npm comprometido ejecuta postinstall → escanea rutas comunes → encuentra tu historial JSONL → exfiltra 50 claves de API en una sola petición
• Rotas la clave que usaste en público pero olvidas las otras docenas en tu historial
• Mientras tanto tu historial crece: cada .env con el que pediste ayuda a una IA, cada URL de BD que compartiste para depurar, cada token que pegaste para un one-liner

El historial de un agente de IA contiene contexto completo, no solo los comandos que conserva un historial de shell. Los atacantes ya lo escanean. agentsweep lo limpia antes de que eso ocurra.

Inicio rápido

pip install uv                  # get uv (skip if you already have it)
uv tool install agentsweep      # install — adds `agentsweep` and `asweep` to PATH
asweep                          # run — interactive menu guides you through everything

No hay virtualenv que activar ni ajustes de PATH. uv tool install le da al comando su propio entorno aislado.

Cómo funciona

agentsweep ejecuta un pipeline fijo de 5 etapas. scan se detiene después de la etapa 3; fix continúa hasta la redacción.

flowchart LR
    A("🔍 DISCOVER\nwalk history dirs\nstream file list") --> B("⚡ SCAN\nAho-Corasick pre-filter\n207 regex rules + BIP-39")
    B --> C{"secrets\nfound?"}
    C -- "none" --> D("✅ CLEAN\nexit 0")
    C -- "found" --> E("📋 FINDINGS\nshow report\nexit 1")
    E -. "scan only" .-> F("⚠️ ROTATE\nkeys still live")
    E -- "type REDACT" --> G("✏️ REDACT\natomic write · .bak backup\npost-write JSON validation")
    G --> H("🔑 ROTATE\nper-provider\nrevocation links")

    style A fill:#1e3a5f,color:#fff,stroke:#2d5986
    style B fill:#1e3a5f,color:#fff,stroke:#2d5986
    style C fill:#4a3728,color:#fff,stroke:#7a5c3f
    style D fill:#1a4731,color:#fff,stroke:#2d7a52
    style E fill:#4a3a1e,color:#fff,stroke:#7a6030
    style F fill:#4a2020,color:#fff,stroke:#8b3a3a
    style G fill:#1e3a5f,color:#fff,stroke:#2d5986
    style H fill:#2d1e4a,color:#fff,stroke:#5a3a8b