SCM Breeze
A shell script suite that adds numbered file shortcuts to git status and provides repository indexing for faster git workflows.
What is SCM Breeze?
SCM Breeze is a set of shell scripts that supercharges git workflows by adding numbered shortcuts to file listings and providing a repository index for quick navigation. It solves the problem of repetitive typing in git commands by allowing users to reference files by numbers instead of full paths, significantly speeding up common operations like adding, committing, and checking out files.
Developers who use git extensively in bash or zsh shells and want to optimize their command-line workflow through faster file selection and repository navigation.
SCM Breeze reduces git command overhead with intuitive numbered shortcuts and repository indexing, offering a lightweight, shell-integrated alternative to memorizing complex aliases or using external GUI tools.
Overview
Adds numbered shortcuts to the output git status, and much more
Use Cases
Best For
- Quickly adding or committing specific files from git status output
- Switching between multiple git repositories with tab completion
- Managing design assets separately from git repositories
- Reducing typing for frequent git operations
- Customizing shell prompts with emojis
- Batch operations across all indexed repositories
Not Ideal For
- Developers who exclusively use GUI git tools or IDEs with integrated version control
- Users on shells not natively supported (e.g., fish or PowerShell) without third-party ports
- Environments with restricted shell customization, such as locked-down corporate systems
- Projects with very infrequent git usage where setup overhead outweighs benefits
Pros & Cons
Pros
Assigns numbers to files in git status and ls output, enabling commands like 'ga 2 3' to add files by number instead of typing full paths, as demonstrated in the screenshot examples.
Maintains an index of all git repos for quick switching with tab completion into subdirectories, shown with examples like 'c cap<TAB>' in the repository index section.
Provides keyboard shortcuts for common git operations, such as CTRL+x c for git_add_and_commit, detailed in the keyboard bindings section with visual prompts.
Integrates design directory management to sync raw assets outside git repos using commands like 'design init', keeping repositories clean, as explained in the linking external design directories part.
Cons
Requires Ruby for some commands to function properly, adding an external dependency that may not be pre-installed on all systems, as noted in the installation section.
Installation modifies .bashrc or .zshrc and requires sourcing changes, which can conflict with existing aliases or scripts, and troubleshooting is often manual.
Only officially supports bash and zsh; fish support is via a separate project (breeze), indicating fragmented development and potential compatibility gaps.
In bash, using custom aliases requires manual configuration for tab completion, as mentioned in the notes about tab completion for aliases section, adding complexity.
Frequently Asked Questions
Related Projects
WWDCThe unofficial WWDC app for macOS
Xcodes.appThe easiest way to install and switch between multiple versions of Xcode - with a mouse click.
PortKillerA powerful cross-platform port management tool for developers. Monitor ports, manage Kubernetes port forwards, integrate Cloudflare Tunnels, and kill processes with one click.
Gas MaskHosts file manager for macOS
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.