# GitX

Turn messy AI-generated changes into clean, safe Git history.

GitX is a portable AI-agent skill that analyzes your changes, groups related files into logical commits, generates Conventional Commit messages, runs project checks, and safely creates branches, pushes, and pull requests.

## Install

```bash npx skills add musoyangrigor/gitx-skill --skill gitx ```

The Skills CLI configures the skill for the selected supported AI agent. Start a new agent session after installation.

## Commands

| Command | Description | | --- | --- | | `$gitx` | Inspect changes and create a smart commit. | | `$gitx body` | Create a smart commit with a useful commit body. | | `$gitx branch` | Create and switch to a branch with an inferred prefix, such as `feat/` or `fix/`. | | `$gitx branch fix/token-refresh` | Create and switch to the named branch. | | `$gitx branch check` | Create an inferred branch, run checks, then commit. | | `$gitx pull` | Safely pull updates for the current branch. | | `$gitx push` | Push the current branch to `origin`; create its upstream if needed. | | `$gitx pr` | Create a GitHub pull request into `origin`'s default branch with a generated title and body. | | `$gitx pr develop` | Create a GitHub pull request from the current branch into `develop`. | | `$gitx issue Login fails after token expiry` | Create a GitHub issue with a generated title and body. | | `$gitx issue 123` | Read GitHub issue `#123` and implement the requested fix in the current working tree. | | `$gitx resolve` | Resolve an in-progress merge or rebase conflict. | | `$gitx check` | Run relevant checks, then create a smart commit. | | `$gitx status` | Show repository status without changing anything. | | `$gitx tree` | Show a compact Git history tree, branch, sync, PR, and working-tree information. | | `$gitx plan` | Preview commit groups and messages without changing anything. | | `$gitx type fix` | Create a smart commit with the `fix` type. | | `$gitx scope auth` | Create a smart comm