init
This commit is contained in:
dualfroz committed
commit
4cf726709f
36 files changed
+8617
No files matched your search
@@ -0,0 +1,322 @@
|
||||
# fxg
|
||||
|
||||
Multi-repository git workflow manager. Zarządzaj repozytoriami na GitHub, GitLab i Gitea z jednego miejsca.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# Linux — opcjonalna zależność systemowa
|
||||
sudo apt install libgit2-dev # Ubuntu/Debian
|
||||
sudo pacman -S libgit2 # Arch
|
||||
|
||||
cargo install --path .
|
||||
fxg --version
|
||||
```
|
||||
|
||||
Binarny plik ląduje w `~/.cargo/bin/fxg` — już jest w PATH po standardowej instalacji Rust. Działa na Windows i Linux.
|
||||
|
||||
---
|
||||
|
||||
## Pierwsze uruchomienie
|
||||
|
||||
```bash
|
||||
fxg config # ustaw workspace_root, username, email
|
||||
fxg auth add --provider github --token ghp_xxxxx
|
||||
```
|
||||
|
||||
Bez tych dwóch kroków większość komend nie zadziała.
|
||||
|
||||
---
|
||||
|
||||
## `fxg status`
|
||||
|
||||
Otwiera TUI — tabelę wszystkich repozytoriów z `workspace_root`:
|
||||
|
||||
```
|
||||
┌ fxg — Workspace Status · 4 repos ──────────────────────────────────────────────┐
|
||||
│ # NAME BRANCH AHEAD BEHIND DIRTY LAST COMMIT │
|
||||
│ 1 my-api main 2 0 ✗ 2h ago │
|
||||
│ 2 my-frontend develop 0 3 ✓ yesterday ← żółty │
|
||||
│ 3 shared-lib main 0 0 ✗ 5d ago │
|
||||
│ 4 infra feat/k8s 1 0 ✓ 30m ago ← żółty │
|
||||
│ │
|
||||
│ [↑/↓] navigate [Enter] drill-in [f] filter [q] quit │
|
||||
└─────────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
Kolory: żółty = dirty (niezcommitowane zmiany), czerwony = behind (trzeba pullować).
|
||||
|
||||
**Enter na repozytorium** → widok szczegółowy:
|
||||
|
||||
```
|
||||
┌ my-frontend · develop ─────────────────────────────────────────────────────────┐
|
||||
│ Branch: develop │
|
||||
│ Status: +0 ahead -3 behind dirty: yes │
|
||||
│ │
|
||||
│ ┌ Modified files ──────────────────────────┐ ┌ Recent commits ───────────────┐ │
|
||||
│ │ M src/components/Nav.tsx │ │ a3f1c2 fix: nav style 2h │ │
|
||||
│ │ M src/styles/theme.css │ │ b89d01 feat: dark mode 1d │ │
|
||||
│ │ ? src/utils/new-helper.ts │ │ c12345 chore: deps 3d │ │
|
||||
│ └──────────────────────────────────────────┘ └───────────────────────────────┘ │
|
||||
│ [p] pull [P] push [c] commit [b] branches [q] back │
|
||||
└─────────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Filtry (z CLI):**
|
||||
```bash
|
||||
fxg status --filter dirty # tylko repo z niezcommitowanymi zmianami
|
||||
fxg status --filter behind # tylko repo, które trzeba pullować
|
||||
fxg status --filter ahead # tylko repo gotowe do pusha
|
||||
fxg status --filter clean # tylko czyste i zsynchronizowane
|
||||
fxg status --workspace work # tylko repo w danym workspace
|
||||
fxg status my-api # bezpośrednio widok szczegółowy konkretnego repo
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## `fxg sync`
|
||||
|
||||
Bez argumentów otwiera TUI — **3-etapowy flow**:
|
||||
|
||||
### Etap 1 — wybór repozytoriów
|
||||
|
||||
```
|
||||
┌ Select repositories (Space = toggle, Enter = confirm) ──────────────────────┐
|
||||
│ [ ] my-api main │
|
||||
│ [x] my-frontend develop ✓ ← dirty │
|
||||
│ [ ] shared-lib main │
|
||||
│ [x] infra feat/k8s ✓ ← dirty │
|
||||
│ │
|
||||
│ [Space] toggle [a] select all [Enter] confirm [q] quit │
|
||||
└──────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
`Space` = toggle zaznaczenia, `a` = zaznacz wszystkie, `Enter` = przejdź dalej.
|
||||
|
||||
### Etap 2 — wybór akcji
|
||||
|
||||
```
|
||||
┌ Action for: my-frontend, infra ────────────────────────────────────────────┐
|
||||
│ Pull │
|
||||
│ Commit │
|
||||
│ ▶ Push │
|
||||
│ New branch │
|
||||
│ Create PR │
|
||||
│ │
|
||||
│ [↑/↓] navigate [Enter] execute [Esc] back │
|
||||
└─────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Etap 3 — wyniki
|
||||
|
||||
```
|
||||
┌ Progress ──────────────────────────────────────────────────────────────────┐
|
||||
│ ✓ my-frontend — push — Pushed develop │
|
||||
│ ✓ infra — push — Pushed feat/k8s │
|
||||
│ │
|
||||
│ [q] quit │
|
||||
└─────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Sync bez TUI (skrypty / CI)
|
||||
|
||||
```bash
|
||||
fxg sync pull --workspace work # pull wszystkich repo w workspace
|
||||
fxg sync pull --all # pull wszystkich repo w workspace_root
|
||||
|
||||
fxg sync commit -m "chore: sync" # commit wszystkich dirty repo (CWD)
|
||||
fxg sync commit -m "chore: sync" --all # commit wszystkich dirty w workspace_root
|
||||
|
||||
fxg sync push --all # push wszystkich
|
||||
fxg sync push --all -m "chore: sync" # najpierw commit dirty, potem push
|
||||
fxg sync push --all --force-with-lease # force push (bezpieczny)
|
||||
```
|
||||
|
||||
> **Uwaga:** `commit` używa tej samej wiadomości dla wszystkich repo. Indywidualne wiadomości per-repo możliwe przez TUI (opcja Commit) — TUI pyta o wiadomość przed wykonaniem commita.
|
||||
|
||||
---
|
||||
|
||||
## `fxg init`
|
||||
|
||||
Bez flagi `--provider` uruchamia **wizard 7-krokowy**:
|
||||
|
||||
```
|
||||
══════════════════════════════════════════
|
||||
fxg — New Repository
|
||||
══════════════════════════════════════════
|
||||
|
||||
Step 1/7 · Repository name: my-new-project
|
||||
> walidacja: brak spacji, niepuste
|
||||
|
||||
Step 2/7 · Provider & Account:
|
||||
> github/personal ← domyślny (zaznaczony)
|
||||
gitlab/work
|
||||
|
||||
Step 3/7 · Visibility:
|
||||
> private
|
||||
public
|
||||
internal
|
||||
|
||||
Step 4/7 · Tags (comma-separated):
|
||||
> rust, cli, tools
|
||||
|
||||
Step 5/7 · Initial files: ← MultiSelect, domyślnie 4 pierwsze zaznaczone
|
||||
[x] README.md
|
||||
[x] .gitignore
|
||||
[x] CHANGELOG.md
|
||||
[x] .env.example
|
||||
[ ] LICENSE ← opcja dostępna ale plik NIE jest generowany (TODO)
|
||||
[ ] CONTRIBUTING.md ← j.w.
|
||||
|
||||
Template:
|
||||
> node
|
||||
rust ← dla Rusta generuje /target\nCargo.lock\n
|
||||
python
|
||||
blank
|
||||
|
||||
Step 6/7 · Extra branches (comma-separated):
|
||||
> dev ← domyślnie
|
||||
|
||||
Step 7/7 · Add collaborators? (y/N)
|
||||
> username: alice
|
||||
role: write
|
||||
> Add another? N
|
||||
|
||||
──────────────────────────────────────────
|
||||
Proceed with creation? (Y/n)
|
||||
```
|
||||
|
||||
**Co się dzieje po potwierdzeniu:**
|
||||
|
||||
```
|
||||
✓ Created remote repo my-new-project (github/personal)
|
||||
✓ Applied tags: rust, cli, tools
|
||||
✓ mkdir ~/projects/my-new-project
|
||||
✓ git init
|
||||
✓ Created initial files
|
||||
✓ Initial commit: "chore: init"
|
||||
✓ git remote add origin git@github.com:user/my-new-project.git
|
||||
✓ git push -u origin main
|
||||
✓ Created branch: dev
|
||||
✓ Added collaborator: alice (write)
|
||||
|
||||
Done in 2.3s · https://github.com/user/my-new-project
|
||||
```
|
||||
|
||||
**Tryb bez wizarda** (name + provider podane → pomija wizard):
|
||||
```bash
|
||||
fxg init my-project --provider github
|
||||
fxg init my-project --provider github --status public --tags rust,cli --branch develop
|
||||
```
|
||||
|
||||
**Batch** — wiele repo naraz:
|
||||
```bash
|
||||
fxg init --batch "api,frontend,shared-lib" # lista inline
|
||||
fxg init --batch repos.txt # plik, jedno repo per linia
|
||||
```
|
||||
W trybie batch: tworzy README, .gitignore, bez CHANGELOG i .env.example.
|
||||
|
||||
---
|
||||
|
||||
## `fxg workspace`
|
||||
|
||||
Grupy repozytoriów do zbiorczych operacji.
|
||||
|
||||
```bash
|
||||
fxg workspace create backend
|
||||
fxg workspace add backend api shared-lib
|
||||
fxg workspace list
|
||||
fxg workspace remove backend
|
||||
```
|
||||
|
||||
```
|
||||
Workspaces:
|
||||
backend (2 repos) api, shared-lib
|
||||
frontend (1 repo) my-frontend
|
||||
```
|
||||
|
||||
Workspace używasz potem w innych komendach: `--workspace backend`.
|
||||
|
||||
---
|
||||
|
||||
## `fxg auth`
|
||||
|
||||
```bash
|
||||
fxg auth # TUI z listą kont
|
||||
fxg auth add --provider github --token ghp_xxx # dodaj konto
|
||||
fxg auth add --provider gitlab --token glpat_xxx
|
||||
fxg auth add --provider gitea --token xxx --url https://git.example.com
|
||||
fxg auth add --provider github --token ghp_xxx --alias work # nazwany alias
|
||||
fxg auth remove github/personal
|
||||
fxg auth switch github/work # ustaw jako domyślne
|
||||
fxg auth test # sprawdź domyślne konto
|
||||
fxg auth test github/work
|
||||
```
|
||||
|
||||
ID konta: `<provider>/<alias>`, np. `github/personal`, `gitea/selfhosted`.
|
||||
Tokeny przechowywane w systemowym keychaine (Windows Credential Manager / macOS Keychain / Linux Secret Service) — nigdy w plikach plaintext.
|
||||
|
||||
---
|
||||
|
||||
## `fxg config`
|
||||
|
||||
Interaktywne TUI do edycji ustawień globalnych. Zapisywane do `~/.fxg/config.toml`.
|
||||
|
||||
```bash
|
||||
fxg config
|
||||
```
|
||||
|
||||
Plik konfiguracyjny (`~/.fxg/config.toml`):
|
||||
|
||||
```toml
|
||||
workspace_root = "/home/user/projects"
|
||||
data_dir = "/home/user/.fxg"
|
||||
default_provider = "github"
|
||||
default_branch = "main"
|
||||
default_visibility = "private"
|
||||
editor = "vim"
|
||||
username = "your-name"
|
||||
email = "you@example.com"
|
||||
gitignore_template = "node"
|
||||
readme_template = "heartbyte-default"
|
||||
share_stats = false
|
||||
timezone = "Europe/Warsaw"
|
||||
vsc_data_dir = "/home/user/.fxg/vsc-data"
|
||||
```
|
||||
|
||||
| Pole | Domyślnie | Opis |
|
||||
|---|---|---|
|
||||
| `workspace_root` | `~/projects` | Gdzie fxg szuka lokalnych repozytoriów |
|
||||
| `data_dir` | `~/.fxg` | Dane fxg (konta, workspace'y) |
|
||||
| `default_provider` | `github` | Provider gdy nie podasz `--provider` |
|
||||
| `default_branch` | `main` | Domyślna gałąź nowych repo |
|
||||
| `default_visibility` | `private` | Widoczność nowych repo |
|
||||
| `editor` | `$EDITOR` lub `vim` | Edytor w interaktywnych flowach |
|
||||
| `username` | _(puste)_ | Git username — używany w commitach |
|
||||
| `email` | _(puste)_ | Git email — używany w commitach |
|
||||
| `gitignore_template` | `node` | Template `.gitignore` (`node`, `rust`, `python`) |
|
||||
| `timezone` | `Europe/Warsaw` | Strefa czasowa w statystykach |
|
||||
| `vsc_data_dir` | `~/.fxg/vsc-data` | Dane VSCode time tracking |
|
||||
|
||||
---
|
||||
|
||||
## Pliki danych
|
||||
|
||||
```
|
||||
~/.fxg/
|
||||
├── config.toml # ustawienia globalne
|
||||
├── accounts.toml # konta (bez tokenów — te są w keychaine)
|
||||
├── workspaces.toml # definicje workspace'ów
|
||||
└── vsc-data/ # dane śledzenia czasu z VSCode (dla fxg stats time)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Providery
|
||||
|
||||
| Provider | wartość `--provider` | Uwagi |
|
||||
|---|---|---|
|
||||
| GitHub | `github` | github.com |
|
||||
| GitLab | `gitlab` | gitlab.com |
|
||||
| Gitea | `gitea` | self-hosted, wymaga `--url` |
|
||||
| Forgejo | `forgejo` | fork Gitea, wymaga `--url` |
|
||||
Reference in new issue
Block a user