chiphuyen

sniffly: Analyze Claude Code Usage and Errors

Sniffly turns local Claude Code logs into a dashboard for usage patterns, errors, and message history. It suits developers who want to review their own workflows or share selected project insights with coworkers.

Stars
1.3k
Forks
118
Stars, last 17 days
+2
Last commit
1.2 years ago
Contributors
3

Our take

Inactiveno commits in over a year

Health score

20/100

How it is scored
Activity
20
Community
18
Issues
21
Pull requests
21

+2 stars in the last 17 days

  • Fewer contributors than 82% of the projects we track

Sniffly offers a focused, local way to inspect Claude Code activity, but its inactive maintenance and reliance on one main contributor make it a cautious choice for long-term team adoption.

Good fit if

  • You use Claude Code and want local analysis of its logs without sending conversations to a service.
  • You are comfortable installing and running a Python 3.10+ CLI tool.
  • You want optional sharing of project stats or instructions and can accept that the project is MIT-licensed.

Look elsewhere if

  • You need a project with active recent maintenance: there have been no commits or releases in over a year.
  • Your team needs broader maintainer capacity: most of the code comes from one person among three contributors.
  • You require recent issue or pull-request resolution as a signal of ongoing support; none were closed or merged in the past 90 days.
All health signals
Last commit2025-08-08 (1.2 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors3 (top contributor: 94% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age15 months

Checked on 2026-10-08 with the GitHub API.

Overview

Sniffly is a local analytics dashboard for Claude Code logs. It helps developers see how they use Claude Code, identify recurring errors, and review the instructions and messages in a project.

The dashboard can also generate shareable views, with options to control whether a dashboard is private or public and whether command text is included. Processing happens locally, and sharing is opt-in.

Key Features

  • Summarizes Claude Code usage patterns in a dashboard.
  • Breaks down errors to help identify where Claude Code makes mistakes.
  • Lets users browse message history and instructions.
  • Creates shareable project dashboards with privacy and command-inclusion options.
  • Runs locally without telemetry, according to the project documentation.
  • Provides CLI configuration for the server, browser behavior, and cache limits.

Use Cases

  • A developer wants to understand their Claude Code usage patterns across projects.
  • A user reviews error categories to spot recurring problems in their Claude Code workflow.
  • A developer walks through prior instructions and messages while refining how they work with Claude Code.
  • A team member shares selected project statistics or instructions with coworkers for discussion.

What you need

Detected in the repository

  • Python >=3.10 (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

With uv installed, run:

uvx sniffly@latest init

The dashboard starts locally, with the default address http://localhost:8081. See the README for installation alternatives and configuration details.

Considerations

Sniffly requires Python 3.10 or newer and analyzes Claude Code logs, so it is specifically useful to people working with Claude Code rather than a general-purpose coding analytics tool. The repository is marked inactive, with no recent commits or releases, and its contributor activity is highly concentrated; teams should account for that maintenance risk. Sharing is optional, but users should review privacy settings before distributing dashboards, especially when including command text.

Found this useful?

Share it with someone who would like sniffly.

Comparisons