https://github.com/jsfr/spoons
Personal Hammerspoon Spoons Repository
https://github.com/jsfr/spoons
Last synced: 2 months ago
JSON representation
Personal Hammerspoon Spoons Repository
- Host: GitHub
- URL: https://github.com/jsfr/spoons
- Owner: jsfr
- License: mit
- Created: 2022-04-07T14:48:25.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2026-02-19T10:48:07.000Z (4 months ago)
- Last Synced: 2026-02-19T15:15:49.031Z (4 months ago)
- Language: Fennel
- Size: 489 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# jsfr's Spoons 🥄
Personal Hammerspoon Spoons Repository
To use this you are expected to be running [Hammerspoon](https://www.hammerspoon.org/), and it is recommended to set up [SpoonInstall](http://www.hammerspoon.org/Spoons/SpoonInstall.html) for easy use of Spoons. See e.g. [this guide](https://zzamboni.org/post/using-spoons-in-hammerspoon/) 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](http://www.hammerspoon.org/Spoons/SpoonInstall.html) you can simply add this repo and use the [`andUse`](http://www.hammerspoon.org/Spoons/SpoonInstall.html#andUse) function. A minimal setup example looks like this
```lua
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](https://github.com/settings/tokens) with the `repo` scope, stored in [skate](https://github.com/charmbracelet/skate). You can store it using:
```sh
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](http://www.hammerspoon.org/Spoons/SpoonInstall.html) you can simply add this repo and use the [`andUse`](http://www.hammerspoon.org/Spoons/SpoonInstall.html#andUse) function. A minimal setup example looks like this
```lua
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](https://docs.microsoft.com/en-us/cli/azure/install-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](http://www.hammerspoon.org/Spoons/SpoonInstall.html) you can simply add this repo and use the [`andUse`](http://www.hammerspoon.org/Spoons/SpoonInstall.html#andUse) function. A minimal setup example looks like this
```lua
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](https://github.com/settings/tokens) with the `repo` scope, stored in [skate](https://github.com/charmbracelet/skate):
```sh
skate set github-api-token [INSERT API TOKEN]
```
- The [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-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](http://www.hammerspoon.org/Spoons/SpoonInstall.html) you can simply add this repo and use the [`andUse`](http://www.hammerspoon.org/Spoons/SpoonInstall.html#andUse) function. A minimal setup example looks like this
```lua
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`](https://www.hammerspoon.org/docs/hs.ipc.html#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`
```sh
## 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"
```