getsentry/claude-settings-audit

¿Qué hace claude-settings-audit?

Analiza un repositorio para generar permisos recomendados de settings.json para Claude Code. Útil al configurar un nuevo proyecto, auditar configuraciones existentes o determinar qué comandos bash de solo lectura permitir. Detecta la pila tecnológica, herramientas de construcción y estructura de monorepositorio.

Uso

Cuando invoques esta habilidad, analizará el repositorio actual o el que especifiques. A continuación, generará un bloque de código JSON con las configuraciones recomendadas para tu archivo settings.json de Claude Code.

Ejemplo de invocación

# Analizar el repositorio actual
claude-settings-audit

# Analizar un repositorio específico
claude-settings-audit /ruta/al/repositorio

Salida esperada

La salida será un bloque JSON como este:

{
  "permissions": {
    "allow": [
      "bash:read-only:git status",
      "bash:read-only:ls -la",
      "bash:read-only:cat"
    ]
  }
}

Comandos detectados

Basado en el análisis del repositorio, la habilidad sugerirá una lista de comandos bash de solo lectura que son seguros y útiles para tu proyecto. Estos comandos pueden incluir:

• git status, git log, git diff – para información del repositorio
• ls, find, cat – para navegación y lectura de archivos
• npm, yarn, pnpm – para inspección de dependencias (sin instalación)
• python, node, rustc – para verificar versiones de herramientas
• docker, kubectl – solo comandos de solo lectura como docker ps o kubectl get

Notas importantes

• Esta habilidad no modifica tu repositorio; solo lee archivos y directorios.
• Los comandos sugeridos son de solo lectura (bash:read-only).
• Puedes revisar y ajustar la configuración generada antes de aplicarla.
• Si tu proyecto tiene configuraciones personalizadas (por ejemplo, archivos .env o Makefile), la habilidad intentará detectarlas.

Soporte de plataformas

Esta habilidad está diseñada exclusivamente para Claude Code.

Limitaciones

• No analiza dependencias binarias o compiladas.
• Los comandos sugeridos se basan en patrones comunes; revisa siempre la configuración generada para tu caso específico.
• No detecta todas las herramientas posibles; si falta alguna, puedes agregarla manualmente.

Personalización

Puedes modificar el archivo settings.json generado para:

• Agregar comandos adicionales
• Cambiar permisos de solo lectura a permisos de escritura si es necesario
• Eliminar comandos que no quieras permitir

---

Esta habilidad es mantenida por la comunidad. Para contribuir o reportar problemas, visita el repositorio original.