Commit Editor

An opinionated, terminal-based text editor for git commit messages, built with Textual.

Title length warning: Characters beyond position 50 on the first line are highlighted in red
Auto-wrap body text: Lines in the commit body (line 3+) are automatically wrapped at 72 characters (except for long strings that can't be wrapped, such as URLs)
White space: Trailing white space is automatically stripped when a file is saved; an empty newline is inserted at the end of the file if not present.
Signed-off-by toggle: Quickly add or remove a Signed-off-by trailer with a keyboard shortcut
Issue ID validation: Optionally enforce that commit titles start with an issue ID (e.g. PROJ-123:)
Status bar: Shows current cursor position (line/column) and title length with warnings

Installation

# Using uv
uv tool install commit-editor

# Using pip
pip install commit-editor

Requirements

Python 3.11 or later
Git (for Signed-off-by functionality)

Usage

Configure commit-editor as your default git commit message editor:

git config --global core.editor commit-editor

When you run git commit, the editor will open automatically.

commit-editor can also be used as a standalone tool with:

commit-editor path/to/file.txt

Keyboard Shortcuts

Shortcut	Action
`Ctrl+S`	Save the file
`Ctrl+Q`	Quit
`Ctrl+O`	Toggle Signed-off-by trailer

Additional key bindings are noted in the Textual TextArea documentation.

Configuration

Issue ID Validation

You can require commit titles to start with an issue ID by setting a regex pattern:

# Per-repository
git config commit-editor.issue-pattern 'PROJ-\d+'

# Global
git config --global commit-editor.issue-pattern 'PROJ-\d+'

The pattern is matched against the start of the title and must be followed by a colon (:). For example, with the pattern PROJ-\d+:

valid: PROJ-123: fix login bug
invalid: fix login bug

Commit Message Format

This editor enforces the widely-accepted git commit message conventions:

Title (line 1): Should be 50 characters or less; characters beyond 50 are highlighted in red as a warning.
Blank line (line 2): Separates the title from the body.
Body (line 3+): Should wrap at 72 characters; long lines are wrapped automatically as you type.

Future Improvements

Color theme support

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

commit_editor-0.6.0.tar.gz (10.9 kB view details)

Uploaded Aug 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

commit_editor-0.6.0-py3-none-any.whl (12.6 kB view details)

Uploaded Aug 7, 2026 Python 3

File details

Details for the file commit_editor-0.6.0.tar.gz.

File metadata

Download URL: commit_editor-0.6.0.tar.gz
Upload date: Aug 7, 2026
Size: 10.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for commit_editor-0.6.0.tar.gz
Algorithm	Hash digest
SHA256	`d47f2dd50809609f54cb6444bcb93aec86c0fc7243c85f14b35960e25fbfaf2d`
MD5	`cef6a93aad7dc7b74fbce68a1cf38537`
BLAKE2b-256	`b0e7ade3b50d87852dad1fb3ac98fbe58104044bb2334002cfbd9846a594e049`

See more details on using hashes here.

Provenance

The following attestation bundles were made for commit_editor-0.6.0.tar.gz:

Publisher: publish.yml on mprpic/commit-editor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: commit_editor-0.6.0.tar.gz
- Subject digest: d47f2dd50809609f54cb6444bcb93aec86c0fc7243c85f14b35960e25fbfaf2d
- Sigstore transparency entry: 2371789256
- Sigstore integration time: Aug 7, 2026
Source repository:
- Permalink: mprpic/commit-editor@6c49f6bd3f451d186609cc415b5495a94d94a56e
- Branch / Tag: refs/tags/0.6.0
- Owner: https://github.com/mprpic
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@6c49f6bd3f451d186609cc415b5495a94d94a56e
- Trigger Event: push