Skip to content

Commit 5fa6c25

Browse files
committed
docs: Add Gitopolis documentation and related journal entry
- Created a new page for Gitopolis, detailing its functionality as a CLI tool for managing multiple git repositories. - Added a journal entry for December 28, 2025, linking to a blog post that explains the use of Gitopolis in a microservices setup. - Included quotes and examples from the blog post to illustrate the practical application of Gitopolis in team onboarding and repository organization.
1 parent 02e8c37 commit 5fa6c25

File tree

3 files changed

+53
-0
lines changed

3 files changed

+53
-0
lines changed

journals/2025_12_28.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
- [[gitopolis]]
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
- [Using Gitopolis to Manage Multiple Git Repositories](https://0x5.uk/2025/10/25/using-gitopolis-to-manage-multiple-git-repositories/)
2+
- [[My Notes]]
3+
- Explains why, in a [[Microservices]] setup, companies need a standard way to structure where [[git/repo]]s are cloned on the hard drive
4+
- Quotes
5+
- The company’s onboarding process mentions “Install Gitopolis”.
6+
Alice drops a copy of `.gitopolis.toml` into the shared Google Drive folder and links it in the new-starter docs.
7+
- When Dana joins the team, she runs:
8+
- ```
9+
mkdir ~/work && cd ~/work
10+
cp ~/GoogleDrive/dev-setup/.gitopolis.toml .
11+
gitopolis clone
12+
```
13+
- All the right repos appear in the right places.
14+
- Alice shows her how to explore the setup:
15+
- ```
16+
$ gitopolis tags --long
17+
- backend
18+
auth
19+
billing
20+
users
21+
orders
22+
payments
23+
inventory
24+
notifications
25+
gateway
26+
shipping
27+
- frontend
28+
web-ui
29+
admin-ui
30+
mobile
31+
design-system
32+
returns
33+
- infra
34+
infra
35+
ci
36+
monitoring
37+
alerts
38+
- shared
39+
shared
40+
devtools
41+
scripts
42+
docs
43+
```
44+
- Dana can instantly see which repos belong to which teams — `backend`, `frontend`, `infra`, `shared`.
45+
She starts working without having to ask where anything lives.

pages/gitopolis.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
alias:: [[Person/Tim Abell/GitHub/gitopolis]]
2+
tags:: [[CLI/Tool]], [[Rust]]
3+
4+
- [timabell/gitopolis: Manage multiple git repositories - CLI tool - run commands, clone, and organize repos with tags](https://github.com/timabell/gitopolis?tab=readme-ov-file)
5+
- See [[Person/Tim Abell/Blog/25/10/Using Gitopolis to Manage Multiple Git Repositories]] for impetus
6+
- [[tldr]]
7+
- like [[GitHub/Desktop]] but more systematic, for a collection of [[git/repo]]s

0 commit comments

Comments
 (0)