Skip to main content

A premium CLI tool to backdate and manage your Git commit history with a sleek web UI.

Project description

CommitX ⏳

CommitX UI

A premium CLI tool designed for developers to manage their Git contribution history with a sleek, modern desktop-web interface. CommitX allows you to seamlessly backdate or forward-date your commits using a high-fidelity "CLI-GUI" dashboard.

Features ✨

  • Premium CLI-GUI Interface: A distinctive "modern coding" aesthetic featuring responsive panels, terminal styling, and real-time process logs.
  • Single Commit Mode: Execute pinpointed commits at any chosen timestamp, with support for multiple iterations (automatic 1-minute increments).
  • Batch Processing: Distribute any number of commits randomly across a specified date range—ideal for populating your contribution graph at scale.
  • Git Hook Integration: Modifies GIT_AUTHOR_DATE and GIT_COMMITTER_DATE to track an activity.log file without manual terminal configurations.
  • Lightweight & Portable: Runs entirely within a local Flask environment, accessible via a global terminal command.

Setup & Installation 🛠️

Ensure you have Python 3.8+ and Git installed.

pip install commitx

Usage 🧠

Once installed, you can launch the tool from any repository directory on your machine:

  1. Open your terminal and cd into your project.
  2. Run the command:
    commitx
    
  3. The application will automatically launch your default web browser to the control panel at http://127.0.0.1:5000.
  4. Select your mode (Single or Batch), pick your dates, and hit "Execute Script".
  5. Watch the real-time terminal logs confirm your commits!

Important Note ⚠️

This application alters your local .git metadata for particular commits. To reflect these backdated changes on GitHub, you must run git push origin [branch-name]. Ensure your terminal has standard Git authorship (user.email and user.name) set correctly.

Author & Credits 🚀

CommitX was created and brought to life by n4od. If this tool made your Git history look a whole lot greener, consider giving the repo a ⭐️ and checking out my other projects!


Built with passion by @n4od.

License 📜

Distributed under the MIT License. See LICENSE for more information.

Project details


Download files

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

Source Distribution

commitx-1.4.0.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

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

commitx-1.4.0-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file commitx-1.4.0.tar.gz.

File metadata

  • Download URL: commitx-1.4.0.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for commitx-1.4.0.tar.gz
Algorithm Hash digest
SHA256 26bceb1f83b273191dd360bc83c566d4f706e96c9f01c7ca6792df0891f3caad
MD5 2fd69353e5cb8686382f8e9ef3ddcecd
BLAKE2b-256 13dd019118e926a04137d64fe3207d2dea1ec7975f893901744b66b155491db4

See more details on using hashes here.

File details

Details for the file commitx-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: commitx-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for commitx-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2eba4c352281748e57f806ecf5fb34b37725514c8fdb1ae0e8198003f9c0516b
MD5 06ac57df32f4d54faf8798f9ff1b4836
BLAKE2b-256 b9f349ee249263c3a9cc689614f5c414210bd458901416b85056f4f609f59ce9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page