jsfr's Spoons 🥄

Personal Hammerspoon Spoons Repository

To use this you are expected to be running Hammerspoon, and it is recommended to set up SpoonInstall for easy use of Spoons. See e.g. this guide for easy setup.

PullRequestGithub

A menubar item showing GitHub Pull Requests the user is part of. The list is split into three parts:

1. Users own PRs.
2. PRs with review requests to be done.
3. PRs the user is otherwise involved in.

Each entry shows the PR status with emoji indicators (✅ approved, ❌ changes requested, ⚔️ conflicts, ⏳ pending). CI check status is also displayed via text color. Draft PRs are shown in grey.

Clicking an entry opens the PR in the default browser.

How to install

If you are using SpoonInstall you can simply add this repo and use the andUse function. A minimal setup example looks like this

hs.loadSpoon("SpoonInstall")

spoon.SpoonInstall.repos.jsfr = {
  url = "https://github.com/jsfr/Spoons",
  desc = "jsfr's Spoons",
  branch = "main"
}

spoon.SpoonInstall:andUse(
  "PullRequestGithub", {
    config = {
      username = "[INSERT GITHUB USERNAME]",
      skateItem = "github-api-token"
    },
    repo = "jsfr",
    start = true
  }
)

You will need a Personal Access Token with the repo scope, stored in skate. You can store it using:

skate set github-api-token [INSERT API TOKEN]

PullRequestsAzure

A menubar item showing Azure DevOps Pull Requests where the user is either the creator or a reviewer. The list is split into two parts:

1. PRs created by the user.
2. PRs where the user is a reviewer.

Each entry shows the PR status with emoji indicators (✅ succeeded, ❌ rejected, ⚔️ conflicts, ⏳ pending). CI build status is also displayed via text color.

Clicking an entry opens the PR in the default browser.

How to install

If you are using SpoonInstall you can simply add this repo and use the andUse function. A minimal setup example looks like this

hs.loadSpoon("SpoonInstall")

spoon.SpoonInstall.repos.jsfr = {
  url = "https://github.com/jsfr/Spoons",
  desc = "jsfr's Spoons",
  branch = "main"
}

spoon.SpoonInstall:andUse(
  "PullRequestsAzure", {
    config = {
      organizationUrl = "https://dev.azure.com/[YOUR_ORG]/",
      project = "[YOUR_PROJECT]",
      userEmail = "[YOUR_EMAIL]"
    },
    repo = "jsfr",
    start = true
  }
)

You will need the Azure CLI installed (defaults to /opt/homebrew/bin/az) and authenticated with az login.

GHADOPullRequest

A menubar item showing both GitHub and Azure DevOps Pull Requests in a single combined menu. PRs from both sources are merged into flat sections, with each entry prefixed by [GH] or [ADO] to indicate the source. The list is split into three parts:

1. Your PRs (GitHub authored/assigned + Azure DevOps created).
2. Review requests (GitHub review requests + Azure DevOps reviewer).
3. Other involved PRs (GitHub only).

Each entry shows the PR status with emoji indicators (✅ approved/succeeded, ❌ changes requested/rejected, ⚔️ conflicts, ⏳ pending). CI status is also displayed via text color. Draft PRs are shown in grey.

Clicking an entry opens the PR in the default browser.

How to install

If you are using SpoonInstall you can simply add this repo and use the andUse function. A minimal setup example looks like this

hs.loadSpoon("SpoonInstall")

spoon.SpoonInstall.repos.jsfr = {
  url = "https://github.com/jsfr/Spoons",
  desc = "jsfr's Spoons",
  branch = "main"
}

spoon.SpoonInstall:andUse(
  "GHADOPullRequest", {
    config = {
      -- GitHub
      username = "[INSERT GITHUB USERNAME]",
      skateItem = "github-api-token",
      -- Azure DevOps
      organizationUrl = "https://dev.azure.com/[YOUR_ORG]/",
      project = "[YOUR_PROJECT]",
      userEmail = "[YOUR_EMAIL]"
    },
    repo = "jsfr",
    start = true
  }
)

You will need:

• A GitHub Personal Access Token with the repo scope, stored in skate:

  skate set github-api-token [INSERT API TOKEN]

• The Azure CLI installed (defaults to /opt/homebrew/bin/az) and authenticated with az login.

YabaiSpaces

A menubar item showing a list of spaces currently containing windows, as well as highlighting the currently active window.

The item comes with the expectation that you are using Yabai as a window manager, and that you have between 1 and 10 spaces.

How to install

If you are using SpoonInstall you can simply add this repo and use the andUse function. A minimal setup example looks like this

require("hs.ipc")

hs.loadSpoon("SpoonInstall")

spoon.SpoonInstall.repos.jsfr = {
  url = "https://github.com/jsfr/Spoons",
  desc = "jsfr's Spoons",
  branch = "main"
}

spoon.SpoonInstall:andUse("YabaiSpaces", {repo = "jsfr"})

You will need to ensure that the hs IPC CLI is installed on your system which can be done by using the hs.ipc.cliInstall

To ensure that the signals which the spoon adds to Yabai are always present you may also want to add the following command to your .yabairc

## Add signals for Hammerspoon Yabai Widget
hs -c "spoon.YabaiSpaces:add_signals()"

# go through all spaces to pick up all windows
active_space=$(yabai -m query --spaces --space | jq -r ".index")
last_space=$(yabai -m query --spaces | jq -r "[.[] | .index] | max")
for i in $(seq 1 "$last_space"); do yabai -m space --focus "$i"; sleep 0.1; done
yabai -m space --focus "$active_space"