gitprompt - AI Developer Tools Tool
Overview
gitprompt is an open-source CLI assistant that uses GPT-4.1 to generate commit messages, analyze diffs, and create logical commits automatically. It scans unstaged changes, performs line-by-line diff analysis, groups related files into commit candidates, and presents colored, interactive previews so you can confirm or reject each commit. The tool supports a dry-run preview, a YOLO (auto-commit) mode, verbose logging that shows the AI system prompt/response, and project-level customization via a .gitprompt rules file. gitprompt is implemented in TypeScript and runs on Node.js or Bun; it requires an OpenAI API key to call GPT-4.1 and follows Conventional Commits by default to produce structured commit titles and descriptions. According to the project README, the tool performs local git operations and only sends diff/context to OpenAI for message generation, with safety checks to prevent committing when files are already staged.
GitHub Statistics
- Stars: 2
- Contributors: 1
- License: MIT
- Primary Language: TypeScript
- Last Updated: 2025-06-08T12:38:53Z
- Latest Release: v1.4.1
The repository is small and early-stage: it has 2 stars, 0 forks, and a single listed contributor, with the latest commit recorded on 2025-06-08. Issues are minimal (0 open issues) and there is one open pull request, indicating limited community activity and adoption so far. The project is MIT-licensed and published to npm (version information available via package registries). Because the codebase is compact and the maintainer notes the code was "vibe coded," expect a lightweight but not yet widely vetted tool; review the source and test in a safe environment before using on critical repositories. ([github.com](https://github.com/xyassini/gitprompt))
Installation
Install via npm:
npx gitpromptOPENAI_API_KEY=your_api_key_here npx gitpromptnpm install -g gitpromptexport OPENAI_API_KEY="your_api_key_here"git clone https://github.com/xyassini/gitprompt.git && cd gitprompt && bun install && bun link (development) Key Features
- GPT-4.1 generated commit messages following Conventional Commits.
- Line-by-line diff analysis to show exact added, removed, and modified lines.
- Smart file grouping that proposes logical multi-file commits.
- Safety checks prevent running with already staged files.
- Interactive colored CLI with per-group confirmation prompts.
- YOLO mode to auto-stage and commit without confirmation.
- Custom rules support via a .gitprompt file or --rules flag.
Community
Community engagement is minimal: the GitHub repo shows 2 stars, 0 forks, and one contributor. There are no open issues and a single pull request, suggesting limited external contributions or user discussions. Share feedback via the repo, but evaluate carefully before adopting in production workflows. ([github.com](https://github.com/xyassini/gitprompt))
Key Information
- Category: Developer Tools
- Type: AI Developer Tools Tool