jetti 0.1.0

A fast, cross-platform tool for organizing git repositories
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

# jetti

A fast, cross-platform tool for organizing git repositories into a consistent directory structure by host, owner, and repo name.

## Install

```sh
cargo install jetti
```

Requires `git` in your PATH.

## Usage

### Clone a repository

```sh
# GitHub (default host, SSH by default)
jetti clone owner/repo

# Explicit host
jetti clone gitlab.com/owner/repo
jetti clone codeberg.org/owner/repo

# Full URLs — protocol is inferred
jetti clone https://github.com/owner/repo.git
jetti clone git@github.com:owner/repo.git

# Shallow clone
jetti clone owner/repo --shallow

# Force HTTPS
jetti clone owner/repo --https

# Force SSH (useful when config defaults to HTTPS)
jetti clone owner/repo --ssh
```

Repositories are cloned to `<root>/<host>/<owner>/<repo>`:

```text
~/dev/
├── github.com/
│   └── rust-lang/
│       └── log/
├── gitlab.com/
│   └── user/
│       └── project/
└── codeberg.org/
    └── user/
        └── repo/
```

### List repositories

```sh
jetti list                              # tree view in terminal
jetti list --full-path                  # absolute paths (flat)
jetti list -p github.com/rust-lang      # filter by prefix
jetti list | fzf                        # fuzzy find (auto-flat)
```

### Fetch and update

```sh
jetti fetch                 # git fetch all repos in parallel
jetti update                # fetch + fast-forward (safe, skips dirty repos)
jetti update -p github.com  # filter by prefix
jetti fetch -j 16           # 16 parallel jobs
```

### Status dashboard

```sh
jetti status                # branch, dirty files, ahead/behind for all repos
jetti status -p github.com  # filter by prefix
```

### Remove a repository

```sh
jetti rm owner/repo           # prompts for confirmation
jetti rm owner/repo --force   # skip confirmation
```

### Configuration

```sh
jetti config          # show current settings
jetti config init     # create default config file
jetti config edit     # open in $EDITOR
```

Config file at `~/.config/jetti/config.toml`:

```toml
root = "/home/user/dev"
default_host = "github.com"
protocol = "ssh"

[[hosts]]
name = "github.com"
ssh_prefix = "git@github.com:"
https_prefix = "https://github.com/"
```

### Shell completions

Add one of the following to your shell configuration:

```sh
# Bash (add to ~/.bashrc)
eval "$(jetti completions bash)"

# Zsh (add to ~/.zshrc)
eval "$(jetti completions zsh)"

# Fish (add to ~/.config/fish/config.fish)
jetti completions fish | source
```

## Shell integration

Jump to a repo with fzf:

```sh
# Add to .bashrc / .zshrc
j() {
  local dir
  dir=$(jetti list --full-path | fzf) && cd "$dir"
}
```

Clone and cd in one step:

```sh
jc() {
  cd "$(jetti clone "$@")"
}
```

## License

MIT