Any workflow. Clean commits. Zero friction.

Stop memorizing
git commands.

contribute-now automates your entire workflow — branching, syncing, committing, and PRs. Supports Clean Flow, GitHub Flow, and Git Flow with GitHub Copilot assistance.

$ npx contribute-now setup
View on GitHub
License: GPL-3.0 npm version runtime
Recommended Workflow

The Ultimate Squash-Merge Workflow

Keep a completely linear history on main while maintaining a stable dev branch for integration. No more messy merges or broken histories.

✓ Squash features → dev → main structure
✓ Smart upstream and origin synchronization
✓ Automated role detection (maintainer vs. contributor)
✓ Supports GitHub Flow and Git Flow too
contrib sync
$ contrib sync ℹ Detecting workflow... Clean Flow ℹ Detecting role... Maintainer ✔ Fetched origin ✔ Synced main from origin/main ✔ Updated dev from origin/dev SUCCESS You are now in sync with main. $
Default Convention

Commit Messages That Make Sense

Stop writing "wip" or "fix". The CLI guides your AI to generate semantic, structured commit messages automatically based on your changes.

✓ Follows Clean Commit or Conventional formats
✓ Auto-generates descriptions from staged diffs
✓ Validates types, scopes, and max lengths
✓ Fully editable before confirming
contrib commit
$ contrib commit ℹ Analyzing staged changes... ℹ Generating message with Copilot... ? Confirm commit message? 1. 📦 new (auth): add biometrics login support 2. 🔧 update (ui): refresh login page styles 3. ✏️ Edit manually... ✔ Committed: 📦 new (auth): add biometrics login support $
GitHub Copilot Powered by GitHub Copilot SDK

AI-Powered Git Assistant

Zero context switching. Let Copilot handle the tedious parts of git directly in your terminal, without ever leaving your workflow.

✓ Generate branch names from natural language
✓ Resolve merge conflicts with smart guidance
✓ Write PR titles & bodies automatically
✓ Select your preferred model with --model
Explore Copilot Features →
contrib start
$ contrib start "fix that annoying login bug" ℹ Asking Copilot for branch names... ? Select a branch name: 1. fix/login-timeout-bug 2. bug/login-session-error 3. ✏️ Enter manually... ✔ Created branch fix/login-timeout-bug from dev ✔ Switched to branch fix/login-timeout-bug SUCCESS Ready to code! $
Quick Start

Up and running in
30 seconds

1

Run setup in your repo

bash 
# no install needed
npx contribute-now setup

# or install globally
npm install -g contribute-now
contrib setup
2

Sync regularly

bash 
contrib sync
# ✓ updates your base branch (main/dev)
# ✓ syncs with upstream automatically
3

Use the full workflow

bash 
contrib start "fix login timeout"   # AI names the branch
contrib commit                       # AI writes the message
contrib update                       # rebase onto base
contrib submit                       # push + open PR
Requirements

Minimal dependencies

required
🔧

Git

Core git commands under the hood. Any recent version works.

git-scm.com →
optional
🐙

GitHub CLI

Enables role auto-detection and PR creation via gh pr create.

cli.github.com →
optional
🤖

GitHub Copilot

Unlocks all AI features. Any active Copilot subscription works.

github.com/features/copilot →

Ready to fix your git workflow?

Try it in any repo — no install required.

$ npx contribute-now setup
⭐ Star on GitHub View on npm →