Command Reference

These pages are generated from the current gtl --help and gtl <command> --help output.

Git Operations

Command	Aliases	Description
`gtl branch`	`b`, `br`	Fuzzy search and checkout branches
`gtl commit`	`c`, `cm`	Create a commit from staged changes
`gtl amend`	`a`	Amend the last commit
`gtl push`	`p`	Auto-commit local changes and push current branch
`gtl merge`	`m`	Merge current branch to main
`gtl main-merge`	`main`	Rebase current branch onto remote main
`gtl sync`	`sy`	Sync current branch with remote
`gtl update`	`up`	Fetch and pull latest remote changes
`gtl fork-sync`	`fs`	Hard sync fork branch to upstream
`gtl sync-loop`		Continuously sync branch at regular intervals
`gtl watch`		Continuously commit local changes at regular intervals
`gtl undo`	`u`	Undo the last commit
`gtl stash`	`sh`	Stash management commands
`gtl clean`	`cl`	Clean merged branches
`gtl diff-branch`	`db`, `diff`	Compare two branches
`gtl worktree`	`wt`	Manage worktrees

Repository Info

Command	Aliases	Description
`gtl status`	`s`, `st`	Show repository status overview
`gtl history`	`h`, `hist`	Show commit history
`gtl dirty`	`d`	Show dirty/uncommitted status
`gtl recent`	`r`	Show recently checked out branches
`gtl search`		Search commits
`gtl contributors`	`contrib`, `ctb`	Show top contributors by scope
`gtl changelog`	`clog`	Generate changelog from conventional commits

Repository Management

Command	Aliases	Description
`gtl find`	`f`, `path`	Find git repositories or resolve repo URLs
`gtl list`		List git repositories as a tree
`gtl repos`		Scan for git repositories
`gtl clone`		Clone repository into organized folders
`gtl url`		Print repository URL for repo, folder, or pull requests
`gtl open`	`o`	Open repository URL in browser
`gtl desktop`	`desk`	Open repository in GitHub Desktop
`gtl exclude`	`x`	Manage git exclude patterns
`gtl ignore`	`ig`	Quickly add ignore patterns
`gtl link`		Link a local folder into .gtl
`gtl identity`	`id`	Manage local git identity for this repository
`gtl env`	`envrc`	Configure repo-local Git, gh, and glab identity
`gtl whoami`	`who`	Show the current GitHub user

GitHub And Pull Requests

Command	Aliases	Description
`gtl pr`	`prw`, `prme`	Fetch and display pull request information
`gtl new-pr`		Create new pull request
`gtl issues`	`i`	Open repository issues in browser
`gtl export`	`ex`	Export PR or issue to markdown
`gtl chat`		Show PR and issue comment timeline
`gtl activity`	`act`	Show GitHub activity

Utility

Command	Aliases	Description
`gtl version`		Show CLI version
`gtl completion`		Generate shell completion scripts
`gtl config`		Manage global gtl configuration