https://github.com/dcchuck/lbranch
A command line utility for checking out recent git branches.
https://github.com/dcchuck/lbranch
git
Last synced: 2 months ago
JSON representation
A command line utility for checking out recent git branches.
- Host: GitHub
- URL: https://github.com/dcchuck/lbranch
- Owner: dcchuck
- License: mit
- Created: 2024-10-24T03:51:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-11T12:55:43.000Z (9 months ago)
- Last Synced: 2025-09-28T10:06:06.978Z (9 months ago)
- Topics: git
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lbranch
lbranch ("last branch") is a git utility that shows your recently checked out branches in chronological order, with an optional interactive checkout.
## Usage
```bash
# Show last 5 branches (default)
lbranch
# Show last N branches
lbranch -n 3
lbranch --number 3
# Show branches and select one to checkout
lbranch -s
lbranch --select
# Show last N branches and select one
lbranch -n 3 -s
# Color control
lbranch --no-color # Disable colored output
lbranch --force-color # Force colored output even in non-TTY environments
```
## Example Output
```bash
Last 5 branches:
1) feature/new-ui
2) main
3) bugfix/login
4) feature/api
5) develop
```
## Color Support
lbranch automatically detects if your terminal supports colors:
- Colors are disabled when output is not to a terminal (when piped to a file or another command)
- Colors are disabled on Windows unless running in a modern terminal (Windows Terminal, VS Code, etc.)
- You can force colors on with `--force-color` or off with `--no-color`
- lbranch respects the `NO_COLOR` and `FORCE_COLOR` environment variables
## Exit Codes
lbranch follows the standard exit codes from sysexits.h for better integration with scripts and other tools:
- 0: Success
- 64: Command line usage error (not in a git repository, invalid selection)
- 66: Cannot open input (no branch history/no commits)
- 69: Service unavailable (git command not found)
- 75: Temporary failure (branch checkout failed, retry possible)
- 130: Operation interrupted (Ctrl+C)
These follow Unix conventions where exit codes 64-78 are standardized error codes, and 128+N indicates termination by signal N.
## Requirements
- Python 3.7+
- Git
## Installation
### Using pip
You can install lbranch directly from [PyPI](https://pypi.org/project/lbranch/):
```bash
pip install lbranch
```
### Using Homebrew
You can install lbranch using [Homebrew](https://brew.sh/):
```bash
brew tap dcchuck/lbranch
brew install lbranch
```
## License
Distributed under the MIT License. See `LICENSE`