fxg
Multi-repository git workflow manager. Zarządzaj repozytoriami na GitHub, GitLab i Gitea z jednego miejsca.
Install
# 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
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):
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)
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:
commituż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):
fxg init my-project --provider github
fxg init my-project --provider github --status public --tags rust,cli --branch develop
Batch — wiele repo naraz:
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.
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
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.
fxg config
Plik konfiguracyjny (~/.fxg/config.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 |