Absortio

Email → Summary → Bookmark → Email

GitHub - chiphuyen/sniffly: Claude Code dashboard with usage stats, error analysis, and sharable feature

Extracto

Claude Code dashboard with usage stats, error analysis, and sharable feature - chiphuyen/sniffly

Resumen

Resumen Principal

Sniffly es un dashboard de analíticas diseñado para procesar y visualizar los logs de Claude Code, ofreciendo a los usuarios una herramienta poderosa para mejorar su interacción y eficiencia con el modelo de IA. Este sistema permite a los desarrolladores obtener una comprensión profunda de sus patrones de uso, identificar y analizar errores recurrentes para prevenirlos, y revisar el historial completo de sus interacciones con Claude Code. Su principal fortaleza reside en que opera completamente en el entorno local del usuario, garantizando la privacidad total de los datos al no enviar información a servidores externos ni emplear telemetría. Sniffly se presenta como una solución integral para la optimización del flujo de trabajo de codificación asistida por IA, proporcionando las herramientas necesarias para la depuración y mejora continua de prompts e instrucciones, accesibles a través de una interfaz de navegador web local una vez inicializado.

Elementos Clave

  • Funcionalidades de Análisis Detallado: Sniffly ofrece capacidades avanzadas para desglosar la interacción con Claude Code. Esto incluye la visualización de patrones de uso para entender cómo se está utilizando la herramienta, un análisis de errores que ayuda a identificar dónde Claude Code comete equivocaciones, permitiendo a los usuarios evitar futuros problemas, y una historia de mensajes completa que permite revisar todas las instrucciones y respuestas.
  • Facilidad de Instalación y Acceso Local: El dashboard puede ser instalado y ejecutado de múltiples maneras, incluyendo el uso de UV (recomendado para una ejecución única o instalación), pip para una instalación estándar de Python, o directamente desde el código fuente de GitHub. Una vez inicializado con sniffly init, se accede al dashboard a través de un navegador web en http://localhost:8081, o un puerto/host configurado por el usuario, enfatizando su operación local.
  • Configuración Personalizable y Solución de Problemas: Sniffly permite a los usuarios personalizar diversos parámetros de su operación. Mediante comandos como sniffly config set [clave] [valor], se pueden ajustar opciones como el puerto del servidor (port), el host, si el navegador se abre automáticamente (auto_browser), y límites de caché (cache_max_projects, cache_max_mb_per_project). También incluye herramientas de diagnóstico para solucionar problemas comunes, como puertos en uso o fallos de apertura del navegador.
  • Privacidad Intrínseca y Opciones de Compartición Seguras: Un pilar fundamental de Sniffly es su compromiso con la privacidad. Todas las operaciones de procesamiento de datos se realizan en la máquina local del usuario, sin telemetría ni envío de conversaciones. Adicionalmente, ofrece una función de compartición del dashboard con opciones de privacidad. Los usuarios pueden generar enlaces para compartir estadísticas e instrucciones de forma Privada (solo con el enlace) o Pública (listado en una galería pública), con la opción de incluir el texto de los comandos reales o no.

Análisis e Implicaciones

Sniffly empodera a los desarrolladores al proporcionar una visibilidad sin precedentes sobre sus interacciones con Claude Code, lo que conduce a una ingeniería de prompts más efectiva y una reducción significativa de errores. Su enfoque en la operación local y la privacidad garantizada lo convierte en una solución confiable para el análisis de código sensible y la optimización del rendimiento de la IA en entornos profesionales.

Contexto Adicional

El proyecto, licenciado bajo MIT License, se beneficia de la transparencia del código abierto, con su documentación completa y gestión de incidencias disponibles en GitHub, fomentando la contribución y el soporte de la comunidad.

Contenido

Sniffly - Claude Code Analytics Dashboard

Analyze Claude Code logs to help you use Claude Code better.

Website | Quickstart | Features | Sharable dashboard

📊 Features

Understanding your usage patterns

Error breakdown

See where Claude Code makes mistakes so that you avoid these mistakes.

Message history analysis

Walk through all your instructions and share them with your coworkers if needed.

🚀 Quickstart

  • Requirement: Python 3.10+

With UV (recommended)

Make sure you have uv installed! https://github.com/astral-sh/uv

# One-time execution (no installation needed)
uvx sniffly@latest init
# Install the package
uv tool install sniffly@latest
sniffly init

After running sniffly init, access your dashboard on your browser at http://localhost:8081 (or whichever host/port you choose).

If you run Sniffly on a remote server, use port forwarding to open the browser on your local computer.

With pip

pip install sniffly
sniffly init

From source

git clone https://github.com/chiphuyen/sniffly.git
cd sniffly
pip install -e .
sniffly init

🔧 Configuration

Common Settings

# Change port (default: 8081)
sniffly config set port 8090

# Disable auto-opening browser
sniffly config set auto_browser false

# Show current configuration
sniffly config show

All Configuration Options

Key Default Description
port 8081 Server port
host 127.0.0.1 Server host
auto_browser true Auto-open browser on start
cache_max_projects 5 Max projects in memory cache
cache_max_mb_per_project 500 Max MB per project
messages_initial_load 500 Initial messages to load
max_date_range_days 30 Max days for date range selection

See full CLI Reference for all options and commands.

💡 Sharing Your Dashboard

You can create a link to share your project's stats and instructions with your coworkers.

  1. Click the "📤 Share" button in your dashboard
  2. Choose privacy options:
    • Private: Only people with the link can view
    • Public: Listed in the public gallery
    • Include Commands: Share your actual command text
  3. Copy and share the generated link

🚨 Troubleshooting

Common Issues

Port already in use?

# Use a different port
sniffly init --port 8090

# Or change default
sniffly config set port 8090

Browser doesn't open?

# Check setting
sniffly config show

# Enable auto-browser
sniffly config set auto_browser true

# Or manually visit http://localhost:8081

Configuration issues?

# View all settings and their sources
sniffly config show

# Reset a setting to default
sniffly config unset port

# Remove all custom config
rm ~/.sniffly/config.json

For more issues, see GitHub Issues.

🔐 Privacy

Sniffly runs entirely on your local machine:

  • ✅ All data processing happens locally
  • ✅ No telemetry
  • ✅ Your conversations never leave your computer
  • ✅ Shared dashboards are opt-in only

📄 License

MIT License - see LICENSE file.

🔗 Links

Fuente: GitHub