DevPulse

AI-Powered Code Intelligence CLI

Understand Your Codebase Instantly ⚡
DevPulse analyzes repositories, detects patterns, and helps developers improve productivity.

---

🧠 What is DevPulse?

DevPulse is a developer productivity tool designed to analyze source code repositories and provide insights about code structure, quality, and project activity.

Goal: Help developers understand their codebase faster.

DevPulse scans projects and produces:

• Repository statistics
• Programming language breakdown
• TODO / FIXME tracking
• Code quality indicators
• Developer productivity insights

Built for:

• 👨‍💻 Individual developers
• 🌍 Open source maintainers
• 🏢 Development teams
• 🎓 Students learning large codebases

---

🚀 Quick Start

Install from PyPI

pip install devpulse-tool

Scan a project

devpulse scan .

Example Output

Scanning project...

Files scanned: 82

Languages detected
- Python: 76%
- Markdown: 15%
- JSON: 9%

TODO items: 12
Code health score: 8.1 / 10

---

⚡ CLI Commands

Scan repository

devpulse scan .

Analyze code quality

devpulse analyze .

Developer productivity metrics

devpulse dashboard

Generate AI commit message

devpulse ai-commit

---

✨ Features

📊 Repository Analysis

DevPulse scans project files to detect:

• Programming languages
• File distribution
• Project complexity

🧾 TODO & FIXME Detection

Automatically detects developer notes:

# TODO
# FIXME
# HACK

Useful for tracking unfinished work.

📈 Code Quality Insights

• Repository structure
• Comment density
• TODO accumulation
• Project organization

🤖 AI Developer Tools

Future AI features include:

• AI commit message generation
• Automated code review hints
• Developer productivity metrics

---

🏗 Architecture

devpulse/
│
├── cli.py
│     CLI entry point
│
├── scanner.py
│     repository scanning engine
│
├── analyzer.py
│     code analysis engine
│
├── dashboard.py
│     developer statistics
│
├── ai_commit.py
│     AI commit message generator
│
└── utils.py
      helper utilities

Core Modules

Module	Purpose
scanner	scans files and directories
analyzer	calculates project metrics
dashboard	visualizes repository stats
ai_commit	generates commit messages
utils	shared helper logic

---

⚙️ How DevPulse Works

1️⃣ Repository Scanning

• File types
• Language detection
• Project structure

2️⃣ Code Analysis

• TODO counts
• File statistics
• Complexity indicators
• Codebase health score

3️⃣ Insight Generation

• Language breakdown
• Developer productivity metrics
• Improvement suggestions

---

📊 Example Output

Project: devpulse

Files scanned: 56

Languages
Python: 88%
Markdown: 12%

TODO items: 7
FIXME items: 2

Code Quality Score: 8.3 / 10

---

🧩 Plugin Architecture

DevPulse supports future plugins.

devpulse/plugins/

security_scanner.py
performance_analyzer.py
dependency_audit.py
documentation_generator.py

Plugins will hook into the analysis pipeline.

---

🧪 Testing

pytest

Coverage includes:

• CLI functionality
• Scanning engine
• Analyzer module

---

📦 Development Setup

Clone repository

git clone https://github.com/manucian-official/devpulse.git

Enter directory

cd devpulse

Install dev mode

pip install -e .

Run CLI

devpulse scan .

---

🧭 DevPulse Vision

DevPulse aims to become a Developer Intelligence Platform.

• AI code review assistant
• Commit quality scoring
• Repository health dashboard
• GitHub integration
• Developer productivity analytics

Long-term goal:

Transform raw source code into actionable developer insights.

---

🤝 Contributing

1. Fork the repository
2. Create a new branch
3. Implement your feature
4. Submit a pull request

---

📄 License

MIT License

---

⭐ Support the Project

If DevPulse helps you analyze code faster, consider giving the project a star.

DevPulse

Code Intelligence for Developers, See yall