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

<center> <img src="assets/features/stats.png" width="800" /> </center>

Error breakdown

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

<center> <img src="assets/features/error-type.png" width="500" /> </center>

Message history analysis

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

<center> <img src="assets/features/command-walkthrough.png" width="1000" /> </center>

🚀 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

sniffly help

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