da-commit

Interactive CLI for writing conventional commits — step by step, in the terminal.

Features

• Interactive TUI built with Ink
• Conventional Commits format with emoji (✨ feat(scope): message)
• Stage/unstage files before committing
• --amend mode to edit the last commit
• --push flag to automatically push after committing
• 14 commit types supported

Install

npm install -g da-commit

Or run without installing:

npx da-commit

Usage

Use da-commit instead of git add . && git commit -m:

# before
git add .
git commit -m "feat: add new feature"

# with da-commit
da-commit

da-commit               # new commit
da-commit --amend       # amend last commit
da-commit --push        # commit then push
da-commit --amend --push  # amend then push

Steps

1. Stage files — select which files to stage (space to toggle, a to toggle all)
2. Commit type — pick a type (feat, fix, chore, ...)
3. Scope — optional scope (e.g. auth, api)
4. Message — short description of the change
5. Preview — review the final commit message before committing

Commit Types

| Type | Emoji | Description | |------------|-------|------------------------------| | feat | ✨ | A new feature | | fix | 🐛 | A bug fix | | chore | 🔧 | Maintenance tasks | | refactor | ♻️ | Code refactoring | | docs | 📝 | Documentation changes | | style | 💄 | Code style changes | | test | ✅ | Adding or updating tests | | perf | ⚡ | Performance improvements | | ci | 👷 | CI/CD changes | | build | 📦 | Build system changes | | revert | ⏪ | Revert a previous commit | | deps | ⬆️ | Dependency updates | | release | 🚀 | Release a new version | | wip | 🚧 | Work in progress |

Keybindings

| Key | Action | |-------------|--------------------| | ↑ / ↓ | Navigate | | space | Toggle file staged | | a | Toggle all files | | enter | Continue / confirm | | esc | Go back |

Requirements

| | Minimum | Check | |---|---------|-------| | Node.js | 18.0.0 | node -v | | npm | 8.0.0 | npm -v | | Git | 2.0.0 | git --version |

Versions below Node.js 18 are not supported due to ESM compatibility.

Install Node.js via nodejs.org or nvm.

# with nvm
nvm install 18
nvm use 18

License

MIT