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 enhttp://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.
- Click the "📤 Share" button in your dashboard
- Choose privacy options:
- Private: Only people with the link can view
- Public: Listed in the public gallery
- Include Commands: Share your actual command text
- 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
- Homepage: sniffly.dev
- Documentation: Full CLI Reference
- Issues: GitHub Issues
Fuente: GitHub