CapsJump GitHub

Caps Lock finally has a job.

It spent decades waiting for someone to SHOUT. Now hold it and press a key: your terminal is just there, GitHub opens in your work Chrome account, the window snaps to half the screen. One small file says which key does what.

brew install --cask whysosuresh/tap/capsjump

Free and open source, for macOS 13 or later.

Caps Lock + G lands on the pull requests tab, in the work account.

Apps

Caps + S and your terminal is just there. Not running? It starts. Hiding with no window? It opens one. No more fishing in the Dock.

Chrome accounts

Caps + G lands on the GitHub tab in your work account. Not your personal one. Never your personal one. No tab yet? It opens one in the right place.

Windows

Caps + an arrow sends the front window to that half of the screen: ← → ↑ ↓. Caps + F and it goes big. Rather other keys? Press the one you want, or turn any off.

Links

Caps + W drops you into a Slack channel, a Zoom room or any web page, in the app that owns the link. Bookmarks, but with legs.

See it

Rather click than write YAML? Pick Edit Config… in the menu bar and every key and site is right there.

The config window on Keys: a sidebar with Sites, Keys and Windows, every key as a keycap with the app's icon or the site's own icon and its account's picture, and the picked key, Caps Lock + G jumping to github, its key field saying Press a key and, under it, E already jumps to mail, you@work.com
Every key that takes you somewhere, on one list in keyboard order. To change a key, click it and press the new one, with Caps Lock or without; a key that's taken says what it does already. Type to search.
The config window on Sites: each site with its own icon, its Chrome account and that account's picture, its host and the keys that land there, a globe for a site Chrome hasn't shown yet, and github open with its Account menu showing each account with its picture
Each site with its own icon, its Chrome account (with the picture Chrome shows for it) and the keys that land on it. Rename one and its keys come along.
The config window on Windows: left half, right half, top half, bottom half and whole screen, each with its key, and Top half open with a picture of the screen's upper half and Caps Lock + up arrow
Every move a key can make, with the key that makes it. Press a new one, or Delete to turn it off.
Add Current Tab: a Figma tab becomes a site named figma, in the Work account with its picture, on Caps Lock + I
Page open in Chrome? Add Current Tab… names it, knows the account, offers a free key. Click Add.

One file, ~/.capsjump.yaml

Each key does one thing, and the window above saves straight to this file, checked by the same rules as you type. Prefer a text editor? Open Config File, and the file looks like this:

sites:
- name: github
  account: you@work.com
  open: https://github.com/your-org/your-repo/pulls

keys:
  s: {app: iTerm}
  t: {app: Finder}
  g: {site: github}
  left: {window: left-half}
  right: {window: right-half}
  up: {window: top-half}
  down: {window: bottom-half}
  f: {window: maximize}
  w: {url: 'slack://channel?team=T123&id=C456'}

Key names: a–z, 0–9, f1–f12 and the arrows. A file with no keys: leaves Caps Lock as it is.

Install

brew install --cask whysosuresh/tap/capsjump
capsjump setup
capsjump init
  1. capsjump setup asks for the permissions once (Accessibility, Chrome automation, notifications) and starts CapsJump at login. A Caps Lock symbol appears in the menu bar.
  2. capsjump init writes a starter ~/.capsjump.yaml in your first Chrome account; capsjump profiles lists the others. Edit it, then run capsjump check.

Moving from stigmer/tap

CapsJump used to install from stigmer/tap. Homebrew doesn't move an installed cask from one tap to another by itself, so if you installed it from there, move it once:

brew uninstall --cask capsjump
brew install --cask whysosuresh/tap/capsjump
open -a CapsJump

The uninstall quits CapsJump, so the last line starts it again. Your Accessibility permission, start-at-login and ~/.capsjump.yaml stay as they are.

Good to know