Git Repositories
The Repositories area of the Welcome window will automatically list Git repositories that you have used with Kaleidoscope. As you are comparing files or changesets of files that are located in a git working directory, Kaleidoscope will automatically recognize the repository and add it to that recent repository list.
Each repository gets an entry in the Repositories view.
Double-click an entry to show the Repository view.
Elements of a repository entry
Icon, Name and Path
Each repository can be identified by an icon, the name of the repository and the local path of the git working directory.
Note: There are 3 ways to customize the look of the entry.
In Finder, paste a custom icon onto the folder of the git working directory.
Place an image named logo.png on the root level of the git working directory.
(You may want to ignore that as part of your repository.)When using a Finder tag, Kaleidoscope will tint the entry background using the tag color.
Heads
Kaleidoscope will show the current heads of your working directory. This typically starts with the symbolic HEAD, unless you are working on a detached head. You also see the current branch(es) and potential tags.
Working Copy Changes
Towards the trailing end, you see a round colored button with a number if there are non-committed changes in your working directory. The number indicates how many changed items there are. Click that button to directly open a changeset document for those changes.
Contextual Menu
Right-clicking or control-clicking on an entry brings up a menu with some of the options described above, plus a few more.
Add Repository
At the end of the list of repositories you will Find an Add Repository button. Click it to locate the working directory of a new to be added to Kaleidoscope.
