CLI Reference

The ProGit binary is called prog. Run it with no arguments to launch the TUI. All utility operations are subcommands.

Global

prog                   # launch TUI (default — this is where you spend 95% of time)
prog --help            # show help
prog --version         # show version

prog sync — Forge synchronisation

Bidirectional sync between local issues and a remote forge (GitLab / Forgejo).

Requires a sync { } block in .project/config.kdl and a token in the environment.

prog sync              # auto-detect: push new, pull updated
prog sync push         # push local issues to forge
prog sync pull         # pull issues from forge to local

Token precedence: PROGIT_TOKEN → GITLAB_TOKEN → FORGEJO_TOKEN → OS keyring (if built with --features keyring-secrets)

prog branch — Branch management

prog branch            # show branch panel in TUI
prog branch list       # list all local git branches
prog branch switch <name>   # switch to a git branch
prog branch create <name>   # create and switch to new branch

prog mr — Merge requests

List and inspect merge requests from your configured forge.

prog mr list           # list open MRs

prog plugin — Plugin management

prog plugin list                      # list installed plugins
prog plugin install <name>            # install from registry
prog plugin install <url> --git       # install from git URL
prog plugin remove <name>             # uninstall a plugin
prog plugin update                    # update all plugins
prog plugin update <name>             # update one plugin
prog plugin search <query>            # search plugin registry
prog plugin info <name>               # show plugin details
prog plugin index update              # refresh local registry index

prog hooks — Git hook integration

ProGit can install git hooks that automatically link commits to issues and run checks.

prog hooks install     # install ProGit hooks into .git/hooks/
prog hooks uninstall   # remove ProGit hooks
prog hooks status      # show which hooks are installed

prog block — Issue blocking

Toggle the blocked status of an issue. Accepts a short ID prefix or full UUID.

prog block abc123      # toggle blocked on issue abc123

prog due — Due dates

prog due abc123 2026-06-01     # set due date (YYYY-MM-DD)
prog due abc123 clear          # remove due date

prog clean — Deduplication

Emergency cleanup if duplicate issues appear (e.g. after a botched sync):

prog clean

Environment variables

Variable	Purpose
PROGIT_TOKEN	Auth token (any provider, checked first)
GITLAB_TOKEN	GitLab / self-hosted GitLab token
FORGEJO_TOKEN	Forgejo / Gitea token
RUST_LOG	Log level (debug, info, warn, error)

Exit codes

Code	Meaning
0	Success
1	General error
2	Configuration error (missing or invalid config.kdl)

Shell completion

prog --help   # completion scripts are planned for v1.0

Notes

• The TUI (prog with no args) is the primary interface — the CLI handles scripting and automation use cases.
• Issue IDs are UUID v4; you only need to type enough characters to be unambiguous (usually 6–8).
• All CLI operations respect .project/config.kdl in the nearest ancestor directory.