claude-code-insights 0.1.0__py3-none-any.whl

claude_code_insights-0.1.0.dist-info/METADATA

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: claude-code-insights
+Version: 0.1.0
+Summary: Local session-history browser, token/cost analytics, and productivity insights for Claude Code.
+Project-URL: Homepage, https://github.com/pragnesh12/claude-code-insights
+Project-URL: Repository, https://github.com/pragnesh12/claude-code-insights
+Project-URL: Issues, https://github.com/pragnesh12/claude-code-insights/issues
+Author-email: Pragnesh Rana <pragnesh.rana@nyusoft.com>
+License: MIT
+License-File: LICENSE
+Keywords: analytics,claude,claude-code,cli,productivity,tokens
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Provides-Extra: tokens
+Requires-Dist: tiktoken>=0.5; extra == 'tokens'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# ◆ claude-code-insights
+
+**Turn your Claude Code session history into a browsable dashboard — with token, cost, and productivity analytics. 100% local.**
+
+[![PyPI](https://img.shields.io/pypi/v/claude-code-insights?color=d97757&label=pypi)](https://pypi.org/project/claude-code-insights/)
+[![Python](https://img.shields.io/badge/python-3.9%2B-6E97D6)](https://pypi.org/project/claude-code-insights/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-5FB389)](LICENSE)
+[![Runs 100% local](https://img.shields.io/badge/runs-100%25%20local-d97757)](#privacy)
+
+</div>
+
+---
+
+`claude-code-insights` reads the `.jsonl` transcripts Claude Code already keeps under
+`~/.claude/projects/`, builds a single self-contained `claude_insights.html` you open in any
+browser, and prints a quick summary to your terminal. No server, no upload, no account.
+
+```text
+Claude Insights — 128 sessions · 14 projects
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Est. tokens:     678K input · 388K output
+Est. cost:       ~$13.08  (Opus pricing)
+Top tool:        Bash (621 calls)
+Busiest day:     2026-06-23 (52 prompts)
+Longest session: Refactor auth flow (4h 12m)
+```
+
+<!--
+  📸 Add a screenshot to make this shine: save a PNG of the dashboard to docs/screenshot.png,
+  then uncomment the block below.
+
+<div align="center">
+  <img src="docs/screenshot.png" alt="claude-code-insights dashboard" width="820">
+</div>
+-->
+
+## Three views
+
+| View | What you get |
+|------|--------------|
+| 🗂️ **History** | Search and filter every session, read full conversations, and export one or all of them to Markdown, CSV, JSON, HTML, or plain text. |
+| 📊 **Analytics** | Estimated token usage and cost, cost-by-project and tool-usage charts, input/output token ratio, your most expensive sessions, and automatic insights (cost spikes, tool-heavy or very long sessions, streaks). |
+| 🔥 **Productivity** | Prompts-per-day trend, an hour-by-day activity heatmap, current/longest streaks, busiest projects, prompt-length distribution, session durations, and clustering of repeated prompt patterns. |
+
+## Install
+
+```bash
+pipx install claude-code-insights        # recommended
+# or
+uvx claude-code-insights                 # run without installing
+# or
+pip install claude-code-insights         # into the current environment
+```
+
+For more accurate token counts (uses `tiktoken`):
+
+```bash
+pipx install "claude-code-insights[tokens]"
+```
+
+## Usage
+
+```bash
+claude-insights              # write claude_insights.html + print a summary
+claude-insights --open       # also open the report in your browser
+claude-insights --cli-only   # terminal summary only, skip the HTML
+claude-insights --dir PATH   # use a custom projects directory
+claude-insights --out FILE   # custom HTML output filename
+claude-insights --version
+```
+
+You can also run it as a module: `python3 -m claude_insights --open`.
+
+## Privacy
+
+Everything runs on your machine — nothing is uploaded anywhere. The generated HTML embeds your
+prompts and responses, which may contain file paths, code, and secrets. **Review the file before
+sharing it with anyone.**
+
+## A note on cost figures
+
+Cost numbers are **estimates**, not real API charges. They multiply estimated token counts by
+Claude **Opus** pricing ($5 / $25 per 1M input / output tokens) — your actual model and rates may
+differ. Treat them as a relative signal, not a bill.
+
+## Development
+
+```bash
+git clone https://github.com/pragnesh12/claude-code-insights
+cd claude-code-insights
+pip install -e ".[tokens]"
+claude-insights --help
+```
+
+## License
+
+[MIT](LICENSE) · An unofficial tool — not affiliated with or endorsed by Anthropic. "Claude" and
+"Claude Code" are trademarks of Anthropic.

claude_code_insights-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+claude_insights/__init__.py,sha256=RoRF1x6jrXO8v1OFtVqXIwvWi2hdwOnvq4o0I3t3Ni0,114
+claude_insights/__main__.py,sha256=yTSfNIgazybVncbQHcOfwg0tLKHplX1eacSxfAAL2uc,120
+claude_insights/cli.py,sha256=yqtfZ_YURGDVEs3eR4Y9H2aemqmM2lOmrOjRsXfVbTs,56936
+claude_code_insights-0.1.0.dist-info/METADATA,sha256=H5c9b__IEyUrp-7IeDIiCMQ4UK8aXZg4T7OoaHIE_kE,5013
+claude_code_insights-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+claude_code_insights-0.1.0.dist-info/entry_points.txt,sha256=G0I51_8o8ddcJutWh58c3U9uz8e92h0-jispqndEVZI,61
+claude_code_insights-0.1.0.dist-info/licenses/LICENSE,sha256=5MZSEPMfBfCR-vAStEG27493zOAp-gUSwyzC_lj4kwk,1070
+claude_code_insights-0.1.0.dist-info/RECORD,,

claude_code_insights-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

claude_code_insights-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-insights = claude_insights.cli:main

claude_code_insights-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pragnesh Rana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_insights/__init__.py

@@ -0,0 +1,3 @@
+"""claude-code-insights — local analytics & history browser for Claude Code sessions."""
+
+__version__ = "0.1.0"

claude_insights/__main__.py

@@ -0,0 +1,6 @@
+"""Enable `python3 -m claude_insights`."""
+
+from claude_insights.cli import main
+
+if __name__ == "__main__":
+    main()