https://github.com/dolfbarr/gprj
Clean & simple CLI git multi project manager
https://github.com/dolfbarr/gprj
cli git nodejs oclif projects typescript
Last synced: 7 months ago
JSON representation
Clean & simple CLI git multi project manager
- Host: GitHub
- URL: https://github.com/dolfbarr/gprj
- Owner: dolfbarr
- Created: 2021-07-27T09:43:40.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T22:45:07.000Z (8 months ago)
- Last Synced: 2025-03-29T12:11:25.144Z (8 months ago)
- Topics: cli, git, nodejs, oclif, projects, typescript
- Language: TypeScript
- Homepage:
- Size: 507 KB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
GPRJ
====
Clean & simple CLI git multi project manager
[](https://oclif.io)
[](https://npmjs.org/package/gprj)
[](https://npmjs.org/package/gprj)
[](https://github.com/dolfbarr/gprj/blob/master/package.json)
[](https://github.com/dolfbarr/gprj/actions/workflows/push.yaml)
* [Installation](#installation)
* [Usage](#usage)
* [Commands](#commands)
* [Thanks](#thanks)
* [License](#license)
# Installation
```sh
$ npm install gprj -g
```
# Usage
```sh-session
$ npm install -g gprj
$ gprj COMMAND
running command...
$ gprj (--version|-v)
gprj/1.1.3 darwin-x64 node-v12.20.2
$ gprj --help [COMMAND]
USAGE
$ gprj COMMAND
...
```
# Commands
* [`gprj add`](#gprj-add)
* [`gprj list`](#gprj-list)
* [`gprj ls`](#gprj-ls)
* [`gprj r`](#gprj-r)
* [`gprj raw`](#gprj-raw)
* [`gprj remove`](#gprj-remove)
* [`gprj rm`](#gprj-rm)
* [`gprj version`](#gprj-version)
## `gprj add`
adds repository to local database
```
USAGE
$ gprj add [-h]
FLAGS
-h, --help Show CLI help.
DESCRIPTION
adds repository to local database
EXAMPLES
$ gprj add /path/to/repo
✔ done Repository repo has been successfully added
```
_See code: [dist/commands/add.ts](https://github.com/dolfbarr/gprj/blob/v1.1.3/dist/commands/add.ts)_
## `gprj list`
lists all repositories
```
USAGE
$ gprj list [-h]
FLAGS
-h, --help Show CLI help.
DESCRIPTION
lists all repositories
ALIASES
$ gprj ls
EXAMPLES
$ gprj list
All repositories:
1. gprj (main)
```
_See code: [dist/commands/list.ts](https://github.com/dolfbarr/gprj/blob/v1.1.3/dist/commands/list.ts)_
## `gprj ls`
lists all repositories
```
USAGE
$ gprj ls [-h]
FLAGS
-h, --help Show CLI help.
DESCRIPTION
lists all repositories
ALIASES
$ gprj ls
EXAMPLES
$ gprj list
All repositories:
1. gprj (main)
```
## `gprj r`
execute a shell command in repo path
```
USAGE
$ gprj r -x [-h] [-t ]
FLAGS
-h, --help Show CLI help.
-t, --timeout= [default: 5000] timeout in ms
-x, --execute= (required) command to execute
DESCRIPTION
execute a shell command in repo path
ALIASES
$ gprj r
EXAMPLES
$ gprj raw /path/to/repo1 /path/to/repo2 --execute='yarn test' --timeout=2000
✔ repo1
✔ repo2
✔ done All commands has been successfully executed
```
## `gprj raw`
execute a shell command in repo path
```
USAGE
$ gprj raw -x [-h] [-t ]
FLAGS
-h, --help Show CLI help.
-t, --timeout= [default: 5000] timeout in ms
-x, --execute= (required) command to execute
DESCRIPTION
execute a shell command in repo path
ALIASES
$ gprj r
EXAMPLES
$ gprj raw /path/to/repo1 /path/to/repo2 --execute='yarn test' --timeout=2000
✔ repo1
✔ repo2
✔ done All commands has been successfully executed
```
_See code: [dist/commands/raw.ts](https://github.com/dolfbarr/gprj/blob/v1.1.3/dist/commands/raw.ts)_
## `gprj remove`
removes repository from local database
```
USAGE
$ gprj remove [-h]
FLAGS
-h, --help Show CLI help.
DESCRIPTION
removes repository from local database
ALIASES
$ gprj rm
EXAMPLES
$ gprj remove /path/to/repo @2 repo
✔ done All repositories have been successfully removed
```
_See code: [dist/commands/remove.ts](https://github.com/dolfbarr/gprj/blob/v1.1.3/dist/commands/remove.ts)_
## `gprj rm`
removes repository from local database
```
USAGE
$ gprj rm [-h]
FLAGS
-h, --help Show CLI help.
DESCRIPTION
removes repository from local database
ALIASES
$ gprj rm
EXAMPLES
$ gprj remove /path/to/repo @2 repo
✔ done All repositories have been successfully removed
```
## `gprj version`
```
USAGE
$ gprj version
```
_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v1.0.4/src/commands/version.ts)_
# Thanks
- GPRJ is inspired a lot by [gita](https://github.com/nosarthur/gita) and [taskbook](https://github.com/klaussinani/taskbook).
- The project is built upon many libs and thanks all the authors!
- Another round of thanks to all the contributors!
# License
Released under [the MIT license](LICENSE).