Beda Schmid
5e63c01bd2
### Added - Non-repository startup flow offering init-only or init+publish paths. - Provider selection for publishing (GitHub via CLI, Gitea via HTTPS API). - Gitea repository creation and initial push over HTTPS with configurable base URL, owner, and token defaults. - Root README and documentation updates describing bootstrap flow and environment variables.
2.4 KiB
2.4 KiB
Usage
Environment Requirements
- Linux or Unix-like terminal environment with curses support.
- Python 3 interpreter available as
python3. - Git installed and available in
PATH. - GitHub CLI
ghinstalled and authenticated for GitHub repository creation. If using Gitea see below. - Gitea API token for Gitea repository creation (read/write permissions for repository and organization) over HTTPS.
Installation
- Make the script executable:
chmod +x git-tui - Install as a memorable command name (example:
gtui):sudo install -m 755 git-tui /usr/local/bin/gtui
Running
- Run from any project directory:
gtui
Non-Repository Bootstrap Flow
- If the current directory is not a Git repository,
git-tuioffers setup actions:- Initialize repository only.
- Initialize and publish to a new remote repository.
- Initialize and publish flow:
- Chooses publishing provider: GitHub or Gitea.
- Initializes a local Git repository.
- Stages all current files.
- Creates an initial commit.
- GitHub option creates and pushes via
gh repo create --source=. --remote=origin --push. - Gitea option creates via HTTPS API, configures
origin, and pushes with HTTPS authentication using the provided token.
- Optional Gitea environment variables:
GITEA_URLorGITEA_BASE_URLfor instance URL default.GITEA_OWNERfor default owner or organization.GITEA_TOKENorGITEA_ACCESS_TOKENfor API token default.
- Git credential prompts are disabled inside
git-tui; authentication issues are reported in the UI instead of opening an interactive terminal prompt.
Key Commands in UI
- Main menu:
Up/Downorj/kto move.Enterto execute selected action.qorEscto quit.
- File selector:
Spaceto toggle file selection.ato toggle all files.Enterto confirm.qorEscto cancel.
Git Operations Covered
- Stage all changes (
git add -A). - Stage selected files (
git add -- <paths...>). - Unstage selected files (
git restore --staged -- <paths...>). - Commit staged changes (
git commit -m "<message>"). - Push current branch (
git push). - Pull with rebase (
git pull --rebase). - Fetch all remotes (
git fetch --all --prune). - Show full status (
git status).
Cross References
- Architecture and contracts:
doc/architecture.md - Change history:
CHANGELOG.md