git-pm 0.1.2

A git CLI plugin for project management (git pm ...)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# git-pm


[![Crates.io](https://img.shields.io/crates/v/git-pm.svg)](https://crates.io/crates/git-pm)
[![Docs.rs](https://docs.rs/git-pm/badge.svg)](https://docs.rs/git-pm)
[![License](https://img.shields.io/crates/l/git-pm.svg)](https://choosealicense.com/licenses/)

A **Git CLI plugin** for project management.  
It lets you create or switch to branches from task strings, enforcing consistent names.

```bash
git pm branch "MINOI-31 Zoom d'images dans galerie"
```

Produces and switches to branch: `feature/MINOI-31-zoom-d-images-dans-galerie`.

## branch


### ✨ Features


- Branch sanitization:
- Keeps task IDs in UPPERCASE
- Lowercases the rest, replaces spaces/punctuation with -
- Handles accents and Unicode (e.g. Fixé → fixe, œuf → oeuf)
- Git-aware:
  - If branch exists → switches to it
  - If not → creates it
- Prefix support:
  - Defaults to feature/
  - Allowed: feature, bugfix, hotfix, release, wip, chore, epic
  - Overridable via .gitpm.toml
- Configurable:
  - Project-local config (.gitpm.toml in repo root)
  - Global fallback ($HOME/.gitpm.toml)

### 🛠 Usage


```bash
git pm branch "<TASK-ID> <description>" [--prefix <prefix>]
```

Examples:

```bash
git pm branch "MINOI-31 Zoom d'images dans galerie"
# => feature/MINOI-31-zoom-d-images-dans-galerie


git pm branch "BUG-42 Fix login bug" --prefix bugfix
# => bugfix/BUG-42-fix-login-bug


git pm branch "HOT-77 Production issue" -p hotfix
# => hotfix/HOT-77-production-issue


git pm branch "TMP-99 Experiment" -p wip
# => wip/TMP-99-experiment

```

## 🚀 Installation


Make sure you have Rust installed, then

```bash

cargo install git-pm

``` 

This provides git pm as a Git subcommand.