git-suggest
Advanced tools
A lightweight command-line tool that automatically generates contextual, high-quality Git commit messages based on your staged code changes. Powered by GitHub Copilot CLI, it helps you write smarter commits with less typing.
A lightweight command-line tool that automatically generates and suggests contextual, high-quality Git commit messages based on your staged code changes. Powered by GitHub Copilot CLI, it helps you write smarter commits with less typing.
git commit -m commandsnpm install -g git-suggest
git-suggest requires:
The installation script will attempt to install missing prerequisites automatically.
Authenticate with GitHub:
gh auth login
Setup shell integration:
git-suggest setup
Restart your terminal or source your shell config:
source ~/.bashrc # or ~/.zshrc
Stage your changes:
git add .
Generate a commit message:
git-suggest generate
Or use the shorthand:
git-suggest g
The tool will analyze your staged changes and present you with options:
📝 Suggested commit message:
"feat(auth): add OAuth2 login integration"
? What would you like to do?
❯ Use this message
Edit this message
Generate another suggestion
Cancel
After running git-suggest setup, you can get autocomplete suggestions when typing:
git commit -m "feat(data-<TAB>
# Automatically suggests: "feat(data-validation): add email format validation"
# Generate with specific type
git-suggest generate --type feat
# Generate with scope
git-suggest generate --type fix --scope auth
# Generate with custom prefix
git-suggest generate --prefix "hotfix:"
# Non-interactive mode
git-suggest generate --no-interactive
git-suggest generate - Generate commit message from staged changesgit-suggest setup - Setup shell integrationgit-suggest check - Check if prerequisites are installedgit-suggest --help - Show help informationgit-suggest supports all conventional commit types:
| Type | Description |
|---|---|
feat | A new feature |
fix | A bug fix |
docs | Documentation only changes |
style | Changes that do not affect the meaning of the code |
refactor | A code change that neither fixes a bug nor adds a feature |
perf | A code change that improves performance |
test | Adding missing tests or correcting existing tests |
chore | Changes to the build process or auxiliary tools |
ci | Changes to CI configuration files and scripts |
build | Changes that affect the build system or external dependencies |
revert | Reverts a previous commit |
git-suggest supports:
SHELL - Automatically detected shell typeHOME - User home directory for config files# You added a new login component
git add src/components/Login.tsx
git-suggest generate
# Output: "feat(auth): add login component with form validation"
# You fixed a validation bug
git add src/utils/validation.js
git-suggest generate
# Output: "fix(validation): handle empty email input correctly"
# You updated the README
git add README.md
git-suggest generate
# Output: "docs: update installation instructions"
# Clone the repository
git clone https://github.com/techuila/git-suggest.git
cd git-suggest
# Install dependencies
npm install
# Build the project
npm run build
# Link for local development
npm link
npm test
npm run lint
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
git checkout -b feature/amazing-feature)git-suggest generate 😉)git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by developers, for developers. Happy committing! 🎉
FAQs
A lightweight command-line tool that automatically generates contextual, high-quality Git commit messages based on your staged code changes. Powered by GitHub Copilot CLI, it helps you write smarter commits with less typing.
We found that git-suggest demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Malicious packages published to npm, PyPI, Go Modules, crates.io, and Packagist impersonate developer tooling to fetch staged malware, steal credentials and wallets, and enable remote access.
Security News
Microsoft has released an open source toolkit for enforcing runtime security policies on AI agents as adoption accelerates faster than governance controls.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.