Repolode
Enviar
jamesalmeida

jamesalmeida/agent-honeypot

Un archivo señuelo que instala un punto de control y un libro de visitas para detectar agentes de IA que aparezcan en tu máquina.

Ver en GitHub
Estrellas
64
Forks
8
Issues abiertos
1
Último commit
hace 15 días

¿Qué es?

agent-honeypot coloca un archivo flag.txt en ubicaciones que probablemente revise un agente de IA visitante, como el directorio personal, /etc, /tmp y el directorio personal de root. El archivo contiene un mensaje de texto sin formato que pide a cualquier agente desconocido que deje de explorar, evite los secretos, corrija solo aquello que pueda identificar con seguridad e informe de lo ocurrido.

El instalador también crea un libro de visitas de solo anexado y con permisos de escritura para todos en ~/guest-book.txt, donde un visitante puede dejar una línea con la fecha y hora que indique quién o qué es y cómo logró entrar. Tus propios agentes, como opencode, Claude Code, Codex y Cursor, aparecen en el archivo para que no se les interrumpa ni firmen el libro de visitas.

Es un punto de control, no una barrera de seguridad: el archivo contiene texto no confiable y no concede ni revoca permisos. Hay instaladores para Linux, macOS (con una entrada sintética opcional /flag.txt que requiere reiniciar) y Windows, donde los enlaces simbólicos y algunas rutas protegidas requieren una sesión de PowerShell con privilegios elevados.

Funciones clave

  • 01Instala un archivo flag.txt canónico y crea enlaces simbólicos hacia ubicaciones habituales de reconocimiento.
  • 02Incluye tus propios agentes en el archivo para que no se les interrumpa.
  • 03Proporciona un libro de visitas de solo anexado y con permisos de escritura para todos, para que los visitantes dejen constancia de su paso.
  • 04Ofrece una entrada sintética opcional /flag.txt para macOS que aparece después de reiniciar.
  • 05Incluye scripts de instalación y desinstalación para Linux, macOS y Windows.

Casos de uso

  • Dejar un punto de control en una máquina de desarrollo personal para comprobar si agentes desconocidos la inspeccionan.
  • Añadir un mecanismo de detección en un servidor compartido o ejecutor de CI para registrar qué agentes aparecen.
  • Experimentar con defensas contra la inyección de prompts en agentes de IA en un entorno controlado.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/jamesalmeida/agent-honeypot.git
  2. 2

    Entra en el directorio del proyecto

    cd agent-honeypot
  3. 3

    Ejecuta el instalador en Linux o macOS

    ./install.sh

Antes de usarlo

  • Nada indica al agente dónde está la marca, así que solo funciona si el agente busca por casualidad en esas ubicaciones.
  • La marca es una solicitud a nivel de prompt y un agente que no se comporte correctamente puede ignorarla.
  • El libro de visitas se basa en declaraciones propias y permite escritura a todo el mundo, así que las entradas son afirmaciones, no pruebas.
  • La instalación completa en Windows requiere una sesión de PowerShell con privilegios elevados.

En colecciones

Frameworks y apps de agentes de IA open sourceApps open source para MacHerramientas de escaneo, auditoría e inteligencia de amenazas

Temas

#ai-agents#honeypot#prompt-injection#security#macos#linux#windows#flag

Preguntas frecuentes

¿Qué es agent-honeypot?
Un archivo señuelo que instala un punto de control y un libro de visitas para detectar agentes de IA que aparezcan en tu máquina. agent-honeypot coloca un archivo flag.txt en ubicaciones que probablemente revise un agente de IA visitante, como el directorio personal, /etc, /tmp y el directorio personal de root. El archivo contiene un mensaje de texto sin formato que pide a cualquier agente desconocido que deje de explorar, evite los secretos, corrija solo aquello que pueda identificar con seguridad e informe de lo ocurrido.
¿agent-honeypot es gratuito? ¿Qué licencia tiene?
agent-honeypot es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agent-honeypot sigue mantenido?
Mantenimiento activo. El último commit de agent-honeypot fue el 23 oct 2026.
¿Para qué puedo usar agent-honeypot?
Dejar un punto de control en una máquina de desarrollo personal para comprobar si agentes desconocidos la inspeccionan. Añadir un mecanismo de detección en un servidor compartido o ejecutor de CI para registrar qué agentes aparecen. Experimentar con defensas contra la inyección de prompts en agentes de IA en un entorno controlado.
¿Cómo se instala agent-honeypot?
Clona el repositorio: git clone https://github.com/jamesalmeida/agent-honeypot.git Entra en el directorio del proyecto: cd agent-honeypot Ejecuta el instalador en Linux o macOS: ./install.sh
¿Dónde consigo agent-honeypot?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jamesalmeida/agent-honeypot

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

nikvdp / cco

Un wrapper de sandbox que ejecuta Claude Code y otros agentes de programación con IA con aprobación automática dentro del aislamiento nativo del sistema operativo o de Docker, para proteger mejor tu equipo.

Seguridad#claude-code#sandbox#ai-agent
42931ShellMITBien mantenidoActualizado el mes pasado