commitpulse 0.1.2

Premium Git repository analytics and dashboard generator

Commit Pulse 💎

A premium, high-fidelity Git repository analytics engine and dashboard generator. Built for engineers who care about their legacy.

• Author: Samuel Olubukun
• Repository: github.com/samolubukun/commitpulse
• License: MIT

Commit Pulse is a powerful, locally-first CLI tool that generates high-fidelity engineering dashboards for your Git repositories. It analyzes your development ecosystem, visualizes commit intensity heatmaps, and identifies top contributors using real GitHub profiles.

✨ Key Features

• Zero-PAT Analysis: Analyzes local .git metadata directly. No Personal Access Tokens or cloud APIs required for core stats.
• Accurate Project Timelines: Dynamic contribution grids that span from the repository's inception to the last official commit.
• GitHub Profile Integration: Automatically fetches actual contributor avatars via the public GitHub Search API.
• Master Scan: A recursive drive scanner that aggregates stats from every project on your machine into a single interactive dashboard.
• Premium Aesthetics: Glassmorphic UI with dark mode, smooth animations, and official GitHub iconography.

📦 Installation

1. Local (Developer Mode)

If you have the source code locally:

pip install -e .

2. Direct from GitHub

Anyone can install your tool directly if the repo is public:

pip install git+https://github.com/YOUR_USERNAME/commitpulse.git

3. Global Command

Once installed, the commitpulse command is available everywhere in your terminal.

🚀 Usage

Publish current repository to Cloud (Default)

commitpulse

Analyze all repositories on your computer (Master Scan & Publish)

commitpulse --scan

Generate a Local HTML Dashboard

commitpulse --local

Specify a target directory

commitpulse /path/to/projects

🛠️ Options

• --scan: Crawls subdirectories to find and aggregate all Git repositories.
• --local: Generates a self-contained, interactive HTML dashboard on your machine.
• --no-open: Prevents the CLI from automatically opening the results in the browser.

🚀 Deployment & Sharing

Commit Pulse offers two ways to view and share your results:

1. Commit Pulse Cloud (Default Workflow)

Ready to show the world? Simply run the base command to host your dashboard on the global registry and get a unique, shareable URL.

commitpulse

Output: https://commitpulse.pxxl.click/v/your-unique-id

2. Local-First (Private Analysis)

Use the --local flag to generate a static HTML dashboard strictly on your machine.

commitpulse --local

Output: stats_dashboard.html (Requires 'y' confirmation)

---

🛠️ Setting up your own Cloud Instance (Optional)

If you are hosting your own version of Commit Pulse Cloud:

1. Neon DB:
   • Go to Neon.tech and create a free project.
   • Copy your Connection String (e.g., postgresql://user:[e-mail]/neondb?sslmode=require).
2. Environment Setup:
   • In the commitpulse-cloud directory, rename .env.example to .env.
   • Paste your connection string into DATABASE_URL.
3. Vercel Deployment:
   • Deploy the commitpulse-cloud folder to Vercel.
   • Add the DATABASE_URL to your Vercel Environment Variables.

🌍 Distribution & PyPI Hosting

To share Commit Pulse with the global developer community via PyPI:

1. Prepare your Account

• Register at pypi.org.
• Generate an API Token in your account settings.

2. Build the Distribution

Ensure you have the latest build tools:

python -m pip install --upgrade build twine

Then build the package:

python -m build

This creates a dist/ folder with your .whl and .tar.gz files.

3. Upload to PyPI

Use twine to securely upload your package:

python -m twine upload dist/*

• Username: __token__
• Password: [Your API Token]

Once uploaded, anyone can install it via:

pip install commitpulse

---

Built with ❤️ for the development ecosystem.