1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# pgt TUI
PyGitTools terminal UI for browsing a local git repository.
## Home page
- **J** / **Up** — move selection up (from the changes list, moves to the branch row, then the repository row)
- **K** / **Down** — move selection down
- **Repository row** — **Enter** opens the projects table (PyGitWeb `PROJECTROOT`)
- **Branch row** — **Enter** opens a filterable list of local branches to check out
- **Commit row** — type a message, then **Enter** to commit staged changes (runs git hooks)
- **Space** / **Left** / **Right** — collapse or expand a section header
- **Enter** on a section header — stage or unstage every file in that section (on **Staged**, Enter stages all unstaged and untracked files when nothing is staged)
- **Enter** on a file — stage (unstaged / untracked) or unstage (staged)
- **H** — open this help page
- **Q** — quit
Commit or hook failures appear in the status bar.
## Branch picker
- **Type** — filter branches by name
- **J** / **Up** — move selection up
- **K** / **Down** — move selection down
- **Enter** — check out the selected branch (`*` marks current), or create a new branch from the current branch when the filter matches nothing
- **Esc** / **Q** — return to the home page
Checkout failures appear in the status bar.
## Projects page
Lists git repositories under the PyGitWeb project directory. Settings are read from
`~/.pygitweb/settings.json` and `PYGITWEB_*` environment variables (same as PyGitWeb):
`PYGITWEB_PROJECTROOT`, `PYGITWEB_PROJECTS_LIST`, `PYGITWEB_PROJECT_MAXDEPTH`, and
`PYGITWEB_LIST_ALL`.
- **J** / **Up** — move selection up
- **K** / **Down** — move selection down
- **Enter** — open the selected project and return to the home page
- **Esc** / **Q** — return without switching
## Help page
- **Up** / **K** — scroll up
- **Down** / **J** — scroll down
- **Q** / **Esc** — return to the previous page
## Command line
Run `pgt` with no arguments to start the TUI from the current directory.
Use `pgt --repo PATH` to open a specific repository.
Run `pgt --help` for full CLI options.