https://github.com/jangelsb/git-plus-alfred-workflow

A fully customizable git & zsh interface for Alfred
https://github.com/jangelsb/git-plus-alfred-workflow

alfred alfred-workflow bash custom git yaml zsh

Last synced: 3 months ago
JSON representation

A fully customizable git & zsh interface for Alfred

• Host: GitHub
• URL: https://github.com/jangelsb/git-plus-alfred-workflow
• Owner: jangelsb
• License: mit
• Created: 2024-11-03T03:32:48.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-09-05T21:00:06.000Z (10 months ago)
• Last Synced: 2025-09-05T23:17:20.838Z (10 months ago)
• Topics: alfred, alfred-workflow, bash, custom, git, yaml, zsh
• Language: Python
• Homepage: https://www.alfredforum.com/topic/22463-git-for-alfred-a-fully-customizable-git-zsh-interface/
• Size: 5.16 MB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# git+ for Alfred: a fully customizable git & zsh interface

`git+` allows you to create personalized commands and menus to fully streamline ✨your✨ workflow!

![Demo](images/demo.gif)

---

For detailed documentation on the commands, see [docs.md](docs.md).

For the official Alfred fourm post, [check here](https://www.alfredforum.com/topic/22463-git-for-alfred-a-fully-customizable-git-zsh-interface/).

---

## 🚀 Features

### Fully functional & customizable

![Custom Commands](images/custom_commands.png)

### Supports multiple repos

![Filter Projects](images/filter_projects.png)

### Checkout branches, tags, commits 

![Checkout Branch](images/checkout_branch.png)

### Create new branches

![Create Branch](images/create_branch.png)

### A powerful status menu

![Filter Projects](images/status_menu.png)

### Ability to view, stage, and unstage hunks

![Create Branch](images/stage_hunk.png)

### And so much more!

* push, push -f

* pull, fetch

* commit

* amend

* stash, pop

* rebase, rebase --onto

* reset

* revert

* cherry-pick

* history

* stage and unstage hunks & files

* copy branch name

* checkout local and remote branch

* checkout tags

* copy diff for tags & branches

* search files in repo

* open repo in Finder, Terminal, Alfred, etc

* `+` anything you want to add 🚀 (see [docs.md](docs.md))

### Tips & Tricks

* You can drag and drop the folders in the git repo list

* You can always press → on the keyboard to see the command that will be run

* `⌘+c` to copy the title of whatever is highlighted - useful for copying branch names!

* the `textview_action` is extremely power - it allows you to run commands and view the output in Alfred and then run followup actions 

    * checkout `history` and `staged` / `modified` actions for examples

---

## 📖 Installation

### Step 1: Set up your `repo list`

```yaml

- title: Repo 1

  path: $repo_path1

- title: Repo 2

  path: "/path/to/repo2"

  config: /path/to/actions.yaml

- path: /Users/name/Developer/ios

  is_root: true

- title: scripts

  path: /path/to/some/folder

  show_default_commands: false

  config: /path/to/custom/scripts.yaml

```

**NOTE**

* If you set a “bash profile”, you can use enviroment variables for your paths, e.g, `$REPO_PATH`

* Optional flags

  * `config` is an optional path to an actions.yaml that is only for that repo.

      * The working directory for that path is the workflow's directory.

  * `is_root: true` is an optional flag that will add all git subfolders (1 layer deep)

      * Folders with the same directory as a manually specified location will be skipped.

  * `show_default_commands: false` is an optional flag that will not include any of the default (git) commands for that location

      * Useful for having a collection of global commands in one spot

### Step 2 (optional)

- Use the default settings

  

- or **make it your own**

  - All commands in this workflow are defined in a YAML config file: [actions.yaml](https://github.com/jangelsb/git-plus-alfred-workflow/blob/main/actions.yaml)

  - Copy [actions.yaml](https://github.com/jangelsb/git-plus-alfred-workflow/blob/main/actions.yaml) to your computer

  - Update your workflow to use this file

  - Customize it 😎

  

### Step 3 (optional)

- **Add custom commands:** 

  - Change the inline config or add another config file in your setup

  - Create specific configs for certain repositories using `config` from Step 1

- **Add custom zsh commands:** 

  - `functions.sh` is implicilty imported before each command that is run. So you can easily offload common commands for better reusability 

  - You can copy [functions.sh](https://github.com/jangelsb/git-plus-alfred-workflow/blob/main/functions.sh) and tweak it or you can even link to your own file 

---

## 📂 Config Example

Here’s a quick example of what a YAML config might look like:  

```yaml

- title: fetch

  icon: down.small.png

  command: |

    git fetch -p

- title: create

  icon: create.png

  command: |

    git checkout -b "[input_snake_case]"

```

For more information, see the full documentation: [docs.md](https://github.com/jangelsb/git-plus-alfred-workflow/blob/main/docs.md).

---

## 🛠️ Installation

1. Download [the latest workflow](https://github.com/jangelsb/git-plus-alfred-workflow/releases) and import it into Alfred. 

2. Configure the paths in the workflow settings

3. Enjoy & God bless 

---

## 📝 Version History

For full change log see: https://github.com/jangelsb/git-plus-alfred-workflow/releases