Skip to content

commit

Interactive conventional commit with file staging, scope selection, and ticket inference.

Alias: devflow c

Branch Protection

If you're on main, master, develop, or production, devflow warns you and asks for confirmation before proceeding.

Flow

  1. If no files are staged, select files to stage (checkbox selection)
  2. Select commit type
  3. Select or enter scope (searchable list if configured, free text otherwise)
  4. Enter commit subject
  5. Optional: enter commit body (longer description)
  6. Confirm if breaking change (adds BREAKING CHANGE: footer)
  7. Optional: enter ticket reference (added as Refs: TICKET footer)
  8. Preview and confirm

Commit Format

type[ticket](scope): message

The ticket is automatically inferred from the branch name. If the branch doesn't follow the type/TICKET_description format, it defaults to UNTRACKED.

Examples

feat[ENV-123](auth): add biometric login
fix[PROJ-45](budget): correct calculation overflow
chore[UNTRACKED](deps): update dependencies
refactor[ENV-200]!(api): restructure endpoints

The ! after the ticket indicates a breaking change.

Options

OptionDescription
--dry-runPreview the commit without executing

Released under the MIT License.