Phrourion

Zie wat aandacht nodig heeft ​

Wie aan meerdere repositories werkt, moet meer controleren dan de huidige diff. Een branch kan achterlopen op de upstream, een pull request kan mislukte checks hebben en een conceptrelease kan nog op afhandeling wachten. Als je iedere checkout en providerpagina apart opent, mis je zulke details gemakkelijk.

Phrourion brengt lokale Git-status en activiteit bij de provider samen in één terminaldashboard. Repositories met conflicten, uiteenlopende branches of mislukte CI staan bovenaan. Niet-gepushte commits, inkomende updates en wachtende releases volgen; rustige checkouts staan onderaan. De selectie blijft bij dezelfde repository als een verversing de volgorde wijzigt.

De animatie gebruikt vaste voorbeeldtoestanden, gegenereerd door het screenshotscript van de repository.

Aan de slag ​

Phrourion is pre-release. Installeer het met Rust 1.85 of nieuwer en Git op je systeem:

cargo install --git https://github.com/AraneaDev/phrourion --locked --bin phro --bin phrourion

Dit installeert zowel phro als phrourion in de bin-map van Cargo, meestal ~/.cargo/bin. Zorg dat die map in je PATH staat. Zoek checkouts onder je werkmap en open het dashboard:

phro discover . --add
phro

Druk op s om provideraccounts in te stellen. GitHub kan ook een al aangemelde gh-CLI gebruiken. Forgejo, GitLab en Bitbucket Cloud gebruiken providertokens. Het Accounts-venster maskeert tokens en bewaart ze in de sleutelbos van het besturingssysteem; omgevingsvariabelen ondersteunen omgevingen zonder grafische sessie. Zie providerauthenticatie voor tokenrechten en zelf gehoste providers.

Lokale wijzigingen en werk bij de provider ​

Voor iedere geregistreerde checkout toont het dashboard de branch, gestagede en ongestagede wijzigingen, niet-gevolgde bestanden, conflicten en lopende Git-operaties. Provideradapters voegen branchstatus, pull requests, issues, workflowchecks en releasegegevens toe.

Onbekende, onbeschikbare en niet-ondersteunde gegevens blijven onderscheiden van een echte nul. Een mislukte aanvraag wordt geen lege lijst. Eerdere waarnemingen blijven zichtbaar met hun verouderde status terwijl een verversing opnieuw wordt geprobeerd. Verouderde of onbeschikbare waarnemingen tellen niet als bevestigde aandachtspunten.

Workspaces groeperen repositories zonder hun registratie te verplaatsen of te dupliceren:

phro workspace create Work
phro workspace add Work phrourion alpheus
phro status --workspace Work

Een checkout kan bij meerdere workspaces horen. Druk op w om te wisselen; All blijft altijd beschikbaar.

Acties vanuit het dashboard ​

Selecteer een repository met j/k of de pijltjestoetsen, open details met Enter, filter met / en ververs met r. Druk op o om de remote in een browser te openen of op t voor een terminal in de repositorymap. De contextafhankelijke toetsenreferentie staat onder ? of F1.

Het dashboard observeert repositories totdat je een actie kiest. Een pull vraagt om bevestiging en gaat alleen door met een schone werkboom, een ongewijzigde gekoppelde branch, een ingestelde upstream en een fast-forward-update. Een pull request uitchecken haalt de pull-request-ref van GitHub op naar een nieuwe branch pr/<nummer>; daarvoor zijn een schone werkboom en een nog ongebruikte lokale branchnaam vereist. Phrourion gebruikt nooit stash, reset of rebase en lost geen conflicten op.

Zolang het dashboard draait, kan een repository die nieuw in een conflict, mislukte CI, uiteenlopende branches of wachtende release terechtkomt één desktopmelding voor die overgang geven.

Opslag en reikwijdte ​

Lokale waarnemingen gebruiken Git-opdrachten; waarnemingen op afstand bevragen de ingestelde provider. Phrourion is een zelfstandige terminalapplicatie en werkt onafhankelijk van een coding agent.

Het register staat in $XDG_CONFIG_HOME/phrourion/repos.toml, of in de configuratiemap van het platform als XDG ontbreekt. Het bewaart checkoutpaden, remote-identiteiten en workspacelidmaatschappen buiten de repositories. Tokens horen in de sleutelbos of omgeving, niet in het register.

Zie de README voor alle opdrachten en de ontwerpnotities voor de providergrens en de controles rond acties.