Smart Commit CLI

The intelligent commit architect for modern developers.

Automatically analyze staged files, detect scopes, and generate clean Conventional Commit messages instantly.

Capabilities

| Feature | Description | | ------------------------- | ------------------------------------------------------------------------- | | Intelligent Suggestions | Detects whether your changes are a feature, fix, docs update, or refactor | | Automatic Scope Detection | Infers commit scopes from directory structure | | Interactive CLI | Guided commit generation with clean prompts | | Diff Summary | Shows additions and deletions before committing | | Emoji Support | Optional Gitmoji-style commits | | Quick Mode | Commit instantly using --quick |

Quick Install

Install globally:

npm install -g smart-commit-cli

Or run instantly:

npx smart-commit-cli

Works on Linux, macOS, and Windows.

🛠 Usage

Stage your changes:

git add .

Run Smart Commit:

smart-commit

Example output:

 Checking git status...

 Staged files:
src/auth/login.js

 Changes Summary:
Files: 1 | +20 additions | -3 deletions

 Suggested commit type: feat

? Commit type: feat
? Scope: auth
? Commit message: add login validation

 feat(auth): add login validation

CLI Commands

smart-commit           # interactive commit workflow
smart-commit --quick   # auto commit using suggestion
smart-commit --no-emoji # disable emoji commits
smart-commit --help    # show CLI help

📸 Screenshots

Commit detection

Interactive prompt

Commit preview

Roadmap

• AI-powered commit message generation
• .smartcommitrc configuration support
• Monorepo scope detection
• Git hook integration

🤝 Contributing

Clone the repo and run locally:

git clone https://github.com/AashirZayd/smart-commit-cli
cd smart-commit-cli
npm install
npm link

Run:

smart-commit

📄 License

MIT License

👤 Author

Aashir Zayd

GitHub https://github.com/AashirZayd

⭐ If this project improves your workflow, consider giving it a star.