Bosswift – A command launcher for git users
Bosswift work along with git worktree to give you power everyday.
System Requirement: macOS 11.0+
A troublesome thing
As a developer，have you ever had this experience?
You are working on some feature development, your colleague Slack you and ask you why an on-live feature is behaving weirdly, he want you to help check the problem and reproduce it.
You say ok, then you open Terminal, type bunch of commands:
# Store your temporary works git stash -u # Switch to problematic branch git checkout release/v1 # Pull the latest changes git pull # Install 3rd dependencies, setup runtime npm install... # Run the project and try to address issue npm run...
This usually will take you couple minutes, and after the issue is resolved, you go back to work on your original task, by type these commands in Terminal:
# Switch back to work branch git checkout feature/in-development # Restore your temporary works git stash apply # Install 3rd dependencies, setup runtime npm install... # Run the project and continue to work npm run...
This can happen multiple times in a day, not just to address a production issue, sometimes you also need to check different branch’s runtime behavior, so you need to switch > build and run > switch > build and run… over and over.
This doesn’t sound productive, what can we do about it?
Well, imagine that if we could checkout multiple branch in same machine from a repo, every branch got it’s own worktree, by this way can we solve the problem?
Yes we did! Git team apparently notice this problem too, start from git v2.5, multiple worktrees support is added, you can create multiple worktree copies from one repo, each worktree got it’s own branch, just like this：
With git worktree，we don’t checkout branch anymore, instead we cd around worktrees，and also no need to stash/unstash anymore：
The most important is, you don’t need to re-install 3rd dependencies constantly, because every worktree is stable if you don’t touch them!
Also if we do it right, git worktree can help us make sure there is always a branch that can run anytime, you don’t need to worry about your in-development works impact other stable worktrees, sometime this is important.
New solution always come with problems
git worktree command got some pain points when using it：
- Too many keystrokes, when you create a new worktree, you need to specify it’s path, it’s branch name, I often make mistake on these arguments
- When you cd around worktrees, you often get lost
- Too many disk usage, because now every worktree got it’s own copy of 3rd dependencies(like node_modules)
✨✨✨ Bosswift ✨✨✨
To solve these pain points come with use git worktree in command line way，Bosswift is born. Bosswift is a GUI app that integrated with git worktree deeply, it will help you manage worktrees without presure.
Installation + Setup
You can download the latest release from here
Some setups is required when you open Bosswift，the only important step is to specify where you put your working repos, so that Bosswift can monitor & sync the worktree status with your repos:
After you done configuration, press Option + Space (Default) to open quick launch bar.
Step 1, search & pick a worktree，hit enter/tab to select it：
Step 2. Search & pick a command, hit enter to execute：
Create new Worktree
When you need a new worktree, do this command:
All you need is to input a branch name:
It will take care these cases for you
- A local branch with same name exist：Switch new worktree to that branch.
- A same name branch exists in remote：Fetch that remote branch to local，create new worktree and switch to that branch.
- Totally new branch：Create new worktree with specified branch name.
You could modify that command, add some steps like “Copy node_modules from original worktree” to the end, to avoid re-install node modules in new worktree.
Whe you no longer work on a worktree, you can save the disk usage by doing this command to delete the worktree：
You could modify that command, add some steps like “Delete Xcode Derived Data folder” to the end, to release disk space.
Create custom commands
What kind of Boss you are if you can’t create your own command?
I encourage you to write commands that suits your project and workflow, I don’t have that energy to provide you a fancy command editor, but I will give you my help as much as I can, there are some variables you can use when creating new command:
For example, if I select feature branch of Doll Repo under path /Users/huikai/dev, here is all variable’s value:
|$BOSSWIFT_WORK_FOLDER||Bosswift’s working folder||/Users/huikai/dev|
|$BOSSWIFT_PROJECT_NAME||Repo’s folder name||Doll|
|$BOSSWIFT_BRANCH_NAME||Selected branch’s name||feature|
|$BOSSWIFT_WORKTREE_PATH||The folder path of current worktree||/Users/huikai/dev/Bosswift_Work/Doll/feature|
|$BOSSWIFT_DEFAULT_WORKTREE_PATH||The folder path of repo’s main worktree||/Users/huikai/dev/Doll|
|$BOSSWIFT_XCODE_DERIVED_PATH||Xcode Derived folder path for worktree (For Apple developers)||/Users/huikai/Library/Developer/Xcode/DerivedData/Doll-cikiwqgnfwrbgzgebttnrazqigks|
|$BOSSWIFT_XCODE_WORKSPACE_FILE||xcworkspace file name inside worktree (For Apple developers)||Doll.xcworkspace|
|$BOSSWIFT_XCODE_PROJECT_FILE||xcodeproj file name inside worktree (For Apple developers)||Doll.xcodeproj|
You can check running tasks in Dashboard:
As an Universal command launcher
Some command can be run from anywhere, and you always forgot how to type them, for example sometimes Xcode failed to recognize iPhone connected by usb cable, to fix that I need to restart usb service, but I never remember the command, I always need to copy it from google or Notes app.
Now with Bosswift，you could put these commands into Universal Command：
Type “/” in quick launch box, then you can pick an Universal Command to run:
As a temporary command launcher
If there’s not command match the keyword in quick launch box, you can hit enter and execute the keyword as command directly:
Command line or GUI?
To be honest, as a developer, I never get used to Terminal.
I’m very careful when doing tasks in command line, I check my input over and over again to make sure I didn’t write to wrong file, delete the wrong folder, I’m rather slow on Terminal because these stresses…
I love GUI, really, proper designed GUI tools is really master pice, easy to use and stress-free. But when it comes to automation, command line just…. kill GUI :). GUI just not design for automation tasks, you just can’t setup the workflow easily with GUI.
Luckly, we don’t have to choice between them, we can have an application that include both Command line and GUI.
This app can’t run without command line, the screen command is the core behind it(For dispatching tasks), and in order to manage running tasks, commands like ps, grep, pkill is necessary too, put all these commands with an easy to use GUI, we got Bosswift :P.
Disclaimer: When it comes to personal project, my code style is rather rough.
I prefer do the damn thing first then see how it goes, if it works I will clear the code and re-architecture, if it’s not working I will keep rough style till it works.
This Repo is currently full of ugly global variables, un-reasonable module separation and un-reliable assumptions about running environment.