refactor(docs): Overhaul README for improved clarity and quick start

The `README.md` has undergone a significant rewrite and restructuring to enhance readability, streamline the onboarding process, and better communicate the value proposition of DevGen. This includes a new introduction, a consolidated "Why DevGen?" section, simplified quick start guides, and a dedicated feature deep dive.

*   **Enhancements & Refinements**
    *   **Improved Introduction**: Added a concise tagline and refined the introductory paragraph, positioning DevGen as an AI co-pilot for Git and project management.
    *   **Streamlined Feature Presentation**: Replaced the previous feature list with a "Why DevGen?" section, highlighting key benefits such as AI Brain (multi-provider support), battle-tested compliance (Conventional Commits, Semantic Versioning), lightning-fast performance, and zero-friction setup.
    *   **Simplified Quick Start**: Refined the initial setup and commit generation steps for a quicker onboarding experience.
    *   **Enhanced Feature Deep Dive**: Introduced a dedicated section to provide detailed usage examples for AI-powered commits, changelogs, release notes, gitignore, and license generation.
    *   **Improved Installation Instructions**: Emphasized `pipx` and `uv` as recommended installation methods for isolated and fast CLI management.
    *   **Concise Configuration Table**: Replaced verbose configuration details with a clear markdown table for easier reference.
    *   **Updated PyPI Link**: Corrected the PyPI link to `devgen-cli`.
    *   **Minor Visual Updates**: Refined badge presentation and added a centered footer with author attribution.

*   **Refactoring**
    *   **Major Content Restructuring**: Completely reordered and rewrote large sections, removing redundant information and consolidating related content to improve overall flow and conciseness.
    *   **Removed Command Reference**: Integrated command examples directly into relevant usage sections, eliminating a separate, lengthy command reference.
    *   **Removed Redundant Sections**: Consolidated information previously found in "Use Cases" and "Requirements" into other sections, streamlining the document.
This commit is contained in:
sankalp committed 2025-12-13 21:42:33 +05:45
1 parent a2f3657269
commit 7c15e2183b
1 file changed
+61 -205
+61 -205
View File
@@ -1,263 +1,119 @@
# DevGen # DevGen
<div align="center"> <div align="center">
> **Your AI Co-Pilot for Git & Project Management.**
> Stop wasting time on repetitive tasks. Automate your commits, changelogs, and project essentials with a single CLI.
>
> PyPI didn't allow the original name, so you'll find it as **devgen-cli** on PyPI > PyPI didn't allow the original name, so you'll find it as **devgen-cli** on PyPI
<img src="https://img.shields.io/pypi/v/devgen-cli?color=blue&label=PyPI&logo=pypi&logoColor=white" alt="PyPI"> <a href="https://pypi.org/project/devgen-cli"><img src="https://img.shields.io/pypi/v/devgen-cli?color=blue&label=PyPI&logo=pypi&logoColor=white" alt="PyPI"></a>
<img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python"> <img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python">
<a href="https://github.com/S4NKALP/DevGen/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg" alt="License"></a> <a href="https://github.com/S4NKALP/DevGen/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg" alt="License"></a>
</div> </div>
**DevGen** is an AI-powered developer toolkit that automates common Git and project management tasks. Generate semantic commit messages, changelogs, release notes, `.gitignore` files, and licenses all from a single unified CLI. ---
## ✨ Features **DevGen** isn't just another CLI tool—it's your development workflow on steroids. By leveraging state-of-the-art AI models, DevGen turns tedious manual tasks into one-click magic. From semantic commit messages to comprehensive release notes, DevGen handles the boring stuff so you can focus on building.
- 🚀 **AI-Powered Commit Messages** - Automatically generate semantic commit messages from your staged changes using AI ## ⚡ Why DevGen?
- 📝 **Changelog Generation** - Create changelogs from git history using conventional commits
- 🚀 **Release Notes** - Generate clean, emoji-enhanced release notes for your releases - **🧠 AI Brain**: Semantic commit messages powered by Gemini, OpenAI, Claude, HuggingFace, and OpenRouter. It reads your diffs and understands your code.
- 🙈 **Gitignore Templates** - Generate `.gitignore` files from GitHub's official templates - **🚀 Battle Tested**: Generates **Conventional Commits** and **Semantic Versioning** compliant changelogs that actually make sense.
- 📄 **License Generation** - Quickly generate open source licenses with interactive setup - **⚡ Lightning Fast**: Smart caching and async operations mean you never wait longer than necessary.
- ⚙️ **Multi-Provider AI Support** - Works with Gemini, OpenAI, Anthropic, HuggingFace, and OpenRouter - **Project Essentials**: Quickly add `.gitignore` and license files to your existing projects. Access cached templates instantly, even without internet.
- **🛠️ Zero Friction**: Interactive setup gets you running in seconds.
## 📦 Installation ## 📦 Installation
```bash Get started in seconds.
# Stable release from PyPI
pip install devgen-cli
# Using pipx (recommended for isolated CLI) ```bash
# Recommended: Install via pipx for an isolated environment
pipx install devgen-cli pipx install devgen-cli
# Using uv (fast Python package manager) # Or use uv for blazing speed
uv tool install devgen-cli uv tool install devgen-cli
# Standard pip install
pip install devgen-cli
``` ```
## 🚀 Quick Start ## 🚀 Quick Start
### 1. Initial Setup **1. Initialize & Configure**
Tell DevGen which AI provider to use.
Configure your AI provider and API key:
```bash ```bash
devgen setup config devgen setup config
``` ```
This will create a configuration file at `~/.devgen.yaml` with your preferred AI provider, model, and API key. **2. Stage & Commit**
Stage your files and let AI write the message.
### 2. Generate Commit Messages
Stage your changes and let DevGen generate semantic commit messages:
```bash ```bash
# Dry run to preview commit messages git add .
devgen commit run
```
*Boom. Done.*
## 💡 Feature Deep Dive
### 🤖 AI-Powered Commits
Stop writing "fix bug" or "wip". DevGen analyzes your staged changes, groups them by component, and generates meaningful, semantic commit messages.
```bash
# Preview what DevGen will generate
devgen commit run --dry-run devgen commit run --dry-run
# Actually commit with AI-generated messages # Commit and push in one go
devgen commit run
# Commit and automatically push
devgen commit run --push devgen commit run --push
# Force regeneration of commit messages
devgen commit run --force-rebuild
``` ```
**How it works:** ### 📝 Changelogs & Release Notes
Turn your git history into beautiful, readable documentation.
- DevGen detects all staged and unstaged changes
- Groups files by directory
- Generates semantic commit messages for each group using AI
- Follows [Conventional Commits](https://www.conventionalcommits.org/) format
**Additional commit commands:**
```bash ```bash
# View cached commit messages # Generate a changelog from the last tag
devgen commit list-cached
# Clear the commit cache
devgen commit clear-cache
# Check what files are staged
devgen commit validate
```
### 3. Generate Changelogs
Create changelogs from your git history:
```bash
# Generate changelog from last tag to HEAD
devgen changelog generate devgen changelog generate
# Generate from a specific reference # Create release notes for v2.0.0
devgen changelog generate --from v1.0.0 devgen release notes --version 2.0.0
# Output to a custom file
devgen changelog generate --output CHANGES.md
``` ```
The changelog follows Semantic Release conventions, categorizing commits into: ### 🛡️ Essential Files
Don't waste time searching for templates. Generate the essential files for your project instantly.
- **BREAKING CHANGES**
- **Features**
- **Bug Fixes**
- **Documentation**
- **Other Changes**
### 4. Generate Release Notes
Create release notes for your releases:
```bash ```bash
# Generate release notes # Interactive search for gitignore templates
devgen release notes --version 1.4.0
# Custom output file
devgen release notes --version 1.4.0 --output RELEASE.md
# From a specific reference
devgen release notes --version 1.4.0 --from v1.3.0
```
### 5. Generate .gitignore Files
Create `.gitignore` files from GitHub templates:
```bash
# Interactive mode (search and select templates)
devgen gitignore generate devgen gitignore generate
# Specify templates directly # Generate a license interactively
devgen gitignore generate Python Node Docker
# List available templates
devgen gitignore list
# Use cached templates (offline mode)
devgen gitignore generate --offline Python
```
**Options:**
- `--append` / `--overwrite` - Append to or overwrite existing `.gitignore`
- `--output` - Specify output file path (default: `.gitignore`)
- `--offline` - Use only cached templates
### 6. Generate Licenses
Generate open source licenses interactively:
```bash
devgen license generate devgen license generate
``` ```
This will:
1. Show available licenses (MIT, Apache-2.0, GPL-3.0, etc.)
2. Prompt for author name
3. Prompt for year (defaults to current year)
4. Generate the license file
**Available licenses:**
- MIT
- Apache-2.0
- GPL-2.0, GPL-3.0
- LGPL-2.1
- AGPL-3.0
- BSD-2-Clause, BSD-3-Clause
- MPL-2.0
- EPL-2.0
- BSL-1.0
- CC0-1.0
- Unlicense
## ⚙️ Configuration ## ⚙️ Configuration
Configuration is stored in `~/.devgen.yaml`. You can edit it manually or use the interactive setup: Your settings live in `~/.devgen.yaml`. You can tweak your AI provider, model, and preferences there.
```bash | Option | Description |
devgen setup config |:---|:---|
``` | `provider` | `gemini`, `openai`, `anthropic`, `huggingface`, `openrouter` |
| `model` | Specific model name (e.g., `gemini-2.5-flash`, `gpt-4o`) |
**Configuration options:** | `emoji` | Enable/disable gitmojis in commits (`true`/`false`) |
- `provider` - AI provider: `gemini`, `openai`, `anthropic`, `huggingface`, or `openrouter`
- `model` - Model name (e.g., `gemini-2.5-flash`, `gpt-4`, `claude-3-opus`)
- `api_key` - Your API key
- `emoji` - Enable/disable emojis in commit messages (default: `true`)
## 📋 Command Reference
### Commit Commands
```bash
devgen commit run [--dry-run] [--push] [--debug] [--force-rebuild]
devgen commit validate
devgen commit list-cached
devgen commit clear-cache
```
### Changelog Commands
```bash
devgen changelog generate [--output FILE] [--from REF]
```
### Release Commands
```bash
devgen release notes [--version VERSION] [--output FILE] [--from REF]
```
### Gitignore Commands
```bash
devgen gitignore generate [TEMPLATES...] [--output FILE] [--append/--overwrite] [--offline]
devgen gitignore list [--cached]
```
### License Commands
```bash
devgen license generate [--output FILE]
```
### Setup Commands
```bash
devgen setup config
```
## 🎯 Use Cases
- **Automated Commit Workflow**: Let AI analyze your changes and generate meaningful commit messages
- **Release Preparation**: Automatically generate changelogs and release notes from git history
- **Project Setup**: Quickly add `.gitignore` and license files to new projects
- **CI/CD Integration**: Use in scripts to automate documentation generation
## 🔧 Requirements
- Python 3.10 or higher
- Git repository (for commit/changelog/release features)
- API key for your chosen AI provider
## 📝 License
This project is licensed under the GPL-3.0-or-later License - see the [LICENSE](LICENSE) file for details.
## 🤝 Contributing ## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. We love contributions! Found a bug? Want a new feature? Open an issue or submit a PR.
## 📚 Links ## 📝 License
- **Homepage**: [https://github.com/S4NKALP/devgen](https://github.com/S4NKALP/devgen) Proudly open source under the [GPL-3.0-or-later](LICENSE) License.
- **PyPI**: [https://pypi.org/project/devgen](https://pypi.org/project/devgen0cli)
## 🙏 Acknowledgments ---
- Uses GitHub's official [gitignore templates](https://github.com/github/gitignore) <div align="center">
- Follows [Conventional Commits](https://www.conventionalcommits.org/) specification Made with ❤️ by <a href="https://github.com/S4NKALP">Sankalp</a>
</div>