PHPackages                             dotninth/xenogit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. dotninth/xenogit

ActiveProject[CLI &amp; Console](/categories/cli)

dotninth/xenogit
================

Your CLI buddy for instant Git commit messages.

v2.5.0(1mo ago)10302MITPHPPHP ^8.2

Since Aug 6Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/dotninth/xenogit)[ Packagist](https://packagist.org/packages/dotninth/xenogit)[ Docs](https://github.com/dotninth/xenogit)[ RSS](/packages/dotninth-xenogit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (18)Versions (26)Used By (0)

[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct-single.svg)](https://supportukrainenow.org/)

 [ ![Xenogit Repository](./.github/assets/xenogit-logo-light.svg) ](https://github.com/dotninth/xenogit/#gh-light-mode-only) [ ![Xenogit Repository](./.github/assets/xenogit-logo-dark.svg) ](https://github.com/dotninth/xenogit/#gh-dark-mode-only)
======================================================================================================================================================================================================================================================

[](#--------------------------------)

 *Your CLI buddy for instant Git commit messages.*

####  [![Latest Stable Version](https://camo.githubusercontent.com/8c51dd56d40d2d9ea5a5bc806d1e65539106878da8e393037e73d13ee8e72413/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76322e352e302d737461626c653f7374796c653d666f722d7468652d626164676526636f6c6f723d433943424646266c6162656c436f6c6f723d333032443431266c6162656c3d737461626c65)](https://camo.githubusercontent.com/8c51dd56d40d2d9ea5a5bc806d1e65539106878da8e393037e73d13ee8e72413/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76322e352e302d737461626c653f7374796c653d666f722d7468652d626164676526636f6c6f723d433943424646266c6162656c436f6c6f723d333032443431266c6162656c3d737461626c65) [![PHP Version](https://camo.githubusercontent.com/a7f4c03bc57d90b21440eda817199269acdf27012e2f3c400ce988d0b14dccda/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f382e322d7068705f76657273696f6e3f7374796c653d666f722d7468652d626164676526636f6c6f723d383964636562266c6162656c436f6c6f723d333032443431266c6162656c3d706870)](https://camo.githubusercontent.com/a7f4c03bc57d90b21440eda817199269acdf27012e2f3c400ce988d0b14dccda/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f382e322d7068705f76657273696f6e3f7374796c653d666f722d7468652d626164676526636f6c6f723d383964636562266c6162656c436f6c6f723d333032443431266c6162656c3d706870) [![MIT License](https://camo.githubusercontent.com/c1d59e9f134ce2866a958affa3b9b4979fd49f890f4bd446e3e2dcc16dc6a519/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d49542d6c6963656e73653f7374796c653d666f722d7468652d626164676526636f6c6f723d636261366637266c6162656c436f6c6f723d333032443431266c6162656c3d6c6963656e7365)](https://camo.githubusercontent.com/c1d59e9f134ce2866a958affa3b9b4979fd49f890f4bd446e3e2dcc16dc6a519/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d49542d6c6963656e73653f7374796c653d666f722d7468652d626164676526636f6c6f723d636261366637266c6162656c436f6c6f723d333032443431266c6162656c3d6c6963656e7365)

[](#------------)

Introduction
------------

[](#introduction)

`Xenogit` is your helpful command-line assistant that uses [Google Gemini](https://deepmind.google/technologies/gemini/) to quickly create commit messages. Stop spending time writing commits and start managing your Git repository effortlessly!

️Getting Started
----------------

[](#️getting-started)

### Installing

[](#installing)

There are two ways to install Xenogit:

1. **Using Composer:** Run the following command to install Xenogit globally:

```
composer global require dotninth/xenogit
```

2. **Downloading from GitHub:** Visit the [Releases page](https://github.com/dotninth/xenogit/releases) on GitHub and download the appropriate binary.

Usage
-----

[](#usage)

After installing Xenogit, you can all available options by simply launcing the program:

```
$ xenogit

  Xenogit  v2.5.0

  USAGE:   [options] [arguments]

  commit         Automatically generate commit messages

  config:api-key Configure the API key in the .env file
```

```
$ xenogit help commit

Description:
  Automatically generate commit messages

Usage:
  commit [options]

Options:
  -m, --model[=MODEL]              Set the ID of the model to use (optional). Default: gemini-2.5-flash-lite
  -t, --temperature[=TEMPERATURE]  Set the temperature (optional). Default: 0
  -k, --tokens[=TOKENS]            Set the maximum number of tokens to use (optional). Default: 100
      --thinking[=THINKING]        Set the thinking level for Gemini 3 models (optional)
  -h, --help                       Display help for the given command. When no command is given display help for the list command
  -q, --quiet                      Do not output any message
  -V, --version                    Display this application version
      --ansi|--no-ansi             Force (or disable --no-ansi) ANSI output
  -n, --no-interaction             Do not ask any interactive question
      --env[=ENV]                  The environment the command should run under
  -v|vv|vvv, --verbose             Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
```

Currently available models
--------------------------

[](#currently-available-models)

You can use the following models from Google with the `-m` flag:

- Gemini 2.5 Flash - `gemini-2.5-flash`
- Gemini 2.5 Flash Lite - `gemini-2.5-flash-lite`
- Gemini 2.5 Pro - `gemini-2.5-pro`
- Gemini 3 Flash - `gemini-3-flash-preview`
- Gemini 3.1 Pro - `gemini-3.1-pro-preview`
- Gemini 3.1 Flash-Lite - `gemini-3.1-flash-lite-preview`

Note

Note that **Gemini 2.5 Pro** and **Gemini 3.1 Pro** models take longer and cost more to generate a commit. But if you have a huge set of changes (huge commit), they work best.

API Key
-------

[](#api-key)

Xenogit needs an [API key from Google AI Studio](https://aistudio.google.com/apikey) to work properly. There are two options to provide the API key:

1. Use the command `xenogit config:api-key `.
2. Using environment variable: Create an environment variable called `API_KEY` that contains your [Gemini API key](https://aistudio.google.com/apikey).
3. Create a file named `.env` in the directory where the Xenogit binary is located. This file will be used to store your environment variables. To the `.env` file, add the following line, replacing `` with your actual [Gemini API key](https://aistudio.google.com/apikey):

```
API_KEY=
```

Payment
-------

[](#payment)

Using Xenogit will cost you money for every request you make to the Gemini API. Xenogit uses the official Gemini 2.5 Flash Lite (`gemini-2.5-flash-lite`) model, which is the best model in terms of price/quality ratio. At least for the task Xenogit solves.

You can also use Free Tier for Gemini. Be sure to check for limitations and be aware that Google will use your data to improve their products.

To find out more about the price for using Google's services, please check their pricing page at [Gemini Pricing page](https://ai.google.dev/gemini-api/docs/pricing).

Bash aliases example
--------------------

[](#bash-aliases-example)

To simplify common workflows, such as adding files to git and committing them, I recommend creating bash aliases.

Here are mine *(sort of a mnemonic for aliases)*:

```
alias xc="xenogit commit"
alias axc="git add . && xc"
alias xcp="xc && git push"
alias axcp="axc && git push"
```

Contribute
----------

[](#contribute)

You are welcome to contribute to Xenogit! For a smooth collaboration, please follow these guidelines when contributing to the project:

1. Fork the repository and clone it to your local machine.
2. Create a new branch for your contribution: `git checkout -b my-contribution`.
3. Make your changes, making sure the code follows the project's coding style and conventions.
4. Test your changes thoroughly.
5. Commit your changes with a descriptive commit message.
6. Push your branch to your forked repository: `git push origin my-contribution'.
7. Open a pull request against the `main' branch of the Xenogit repository.
8. Provide a clear and detailed description of your changes in the pull request, along with any relevant information or context.

Please note that by contributing to Xenogit, you agree to release your contributions under the [MIT License](LICENSE.md).

License
-------

[](#license)

Xenogit is released under the [MIT License](LICENSE.md). Feel free to modify and distribute it according to your needs.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance92

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 98.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~40 days

Recently: every ~78 days

Total

25

Last Release

38d ago

Major Versions

v1.3.2 → v2.0.02025-02-20

PHP version history (2 changes)v1.0.0PHP ^8.1

v2.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/41db62ca6886bcd35259d6b5ae633f3c73de98e5c90de31848646afb62981eb8?d=identicon)[dotninth](/maintainers/dotninth)

---

Top Contributors

[![dotninth](https://avatars.githubusercontent.com/u/25880190?v=4)](https://github.com/dotninth "dotninth (152 commits)")[![dark-elk](https://avatars.githubusercontent.com/u/30667389?v=4)](https://github.com/dark-elk "dark-elk (3 commits)")

---

Tags

aichatgptclaude-aicommitcommitsgeminigemini-aigitmessagecliconsoleGPT-3gitcommitGeminiclaudegptChatGptperplexitygpt-4gpt3gitprompt

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/dotninth-xenogit/health.svg)

```
[![Health](https://phpackages.com/badges/dotninth-xenogit/health.svg)](https://phpackages.com/packages/dotninth-xenogit)
```

###  Alternatives

[guanguans/ai-commit

Automagically generate conventional git commit message with AI. - 使用 AI 自动生成约定式 git 提交信息。

39231.2k10](/packages/guanguans-ai-commit)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[mehrancodes/laravel-harbor

A CLI tool to Quickly create On-Demand preview environment for your apps.

9989.0k](/packages/mehrancodes-laravel-harbor)[sbsaga/toon

🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts &amp; LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON).

6115.6k](/packages/sbsaga-toon)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
