# git-perm-rm

**Repository Path**: mirrors_kaelzhang/git-perm-rm

## Basic Information

- **Project Name**: git-perm-rm
- **Description**: Permanently remove a file or directory from a git repo.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git-perm-rm

Permanently remove a file or directory from a git repo including all related commit records.

It's a very usefull script to get your git repo more sexy and slim, but at the meantime, it is dangerous and irreversible !

## Usage

### Remove directories

```sh
# bash
cd /your/repo
git-perm-rm node_modules temp -r
```
### Remove file(s)

```
cd /your/repo
git-perm-rm index.js
```

## Install

Install with npm

```sh
npm install -g git-perm-rm
```

Or, clone the repo, edit your `~/.bashrc` file, add the following code:

```sh
alias="bash /your/repo/git-perm-rm.sh"
```