https://github.com/microhod/repo
A cli application to organise scm repositories in a structured hierarchy
https://github.com/microhod/repo
Last synced: 3 months ago
JSON representation
A cli application to organise scm repositories in a structured hierarchy
- Host: GitHub
- URL: https://github.com/microhod/repo
- Owner: microhod
- License: mit
- Created: 2021-12-31T17:51:15.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-25T13:14:05.000Z (8 months ago)
- Last Synced: 2025-10-25T13:14:52.482Z (8 months ago)
- Language: Go
- Size: 42 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Repo
`repo` is a cli application to organise scm repositories in a structured hierarchy.
For example, `github.com/microhod/repo.git` would be stored at `~/src/github.com/microhod/repo`.
## Usage
Run `repo --help` to see full CLI usage.
```
NAME:
repo - A cli application to organise scm repositories in a structured heirachy
USAGE:
repo [global options] command [command options] [arguments...]
COMMANDS:
clone clone a repo
organise organise all repos under the current path into a structured heirachy
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--help, -h show help (default: false)
```
## Install
### Compile from Source
* Install [golang](https://golang.org/doc/install) `1.25` or later
* Run `go install github.com/microhod/repo@latest` to download and install the binary (this will install to `~/go/bin`)
## Config
Configuration will be auto-generated at first startup and stored at `~/.config/repo/config.json`.
The default configuration is as below:
```json
{
"remote": {
"default": {
"prefix": "ssh://git@github.com"
}
},
"local": {
"root": "~/src"
}
}
```
## Todo
- [ ] `--verbose` option for all commands
- [ ] add `profile` command generate terminal profile for utlity commands