An open API service indexing awesome lists of open source software.

https://github.com/aganzha/stage

Stage - Git GUI client for linux desktops inspired by Magit
https://github.com/aganzha/stage

developer-tools flatpak git gtk-rs gtk4 gui-application libadwaita

Last synced: 3 months ago
JSON representation

Stage - Git GUI client for linux desktops inspired by Magit

Awesome Lists containing this project

README

        


Stage logo
Stage -
Git GUI client for linux desktops inspired by Magit

![CI Build/Tests](https://github.com/aganzha/stage/actions/workflows/tests.yml/badge.svg)

## Installing
Add flathub to your remotes
```sh
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
```
Install app
```sh
flatpak install flathub io.github.aganzha.Stage
```
To update app to latest version run
```
flatpak update io.github.aganzha.Stage
```

## Running
```sh
flatpak run io.github.aganzha.Stage
```
## Using
To create commit, it need "to stage" `Unstaged changes` either all of them or separate files/hunks.
> [!NOTE]
> You can use either buttons in headerbar or press `command keys` on your keyboard which will apply to line highlighted by cursor. All actions could be driven by keyboard

- Use Ctrl + / Ctrl - to change font size.
- dark / light theme switcher is in the burger

Stage screenshot

### Staging

- **Expand/collapse** underlying files and hunks by pressing `TAB` or `SPACE` or `clicking` expandable items on screen.

- **Stage** selected files or hunks or all changes by pressing `ENTER` or `S` or `double clicking` items on screen

- **Unstage** staged changes by pressing `U` or `double clicking` while cursor is on staged items.

- **Kill** unstaged changes by pressing `K` while cursor is on unstaged items.

### Commit/Push/Pull
- **Commit** hit `C` or press Commit button button
- **Pull** hit `F` (fetch) or press Pull button button
- **Push** hit `P` or press Push button button

### Branches
Hit `B` in Status view or press Branches button button to open Branches view.
Branches view

#### Resolving conflicts
When in conflict hit `S` to either Theirs or Others side of conflict to choose change to be applied.

### Log
Pressing `L` opens log view or Push button opens **Git log view**

### Cherry-pick/Revert
Both actions are available on all views (Branches, Logs, Commit and Stash views) by pressing respectivelly `A` (apply) `R` (revert)
Apply button Revert button buttons.

### Stash
Pressing `Z` or Push button opens **Stashes panel**
Stashes view

### Tags
Pressing `T` opens Tags view