Features › Site Kits and App Kits

Add features to a website or a Mac app that isn’t yours

A kit is a group of macros scoped to one website or one Mac app, with a folder of real files beside them. A Site Kit adds buttons and commands inside a web page, and an App Kit adds them around a Mac app. Both reload when you save a file, re-check themselves when the site or app updates, and travel as one file. A kit that leans on a site’s layout will break when the site changes, so Activity warns you before you hit it.

Coming soon See pricing

What it does

Site Kits

  1. GitHub should have a button beside Merge that merges the pull request and closes its Linear issue.

    The kit puts the button there and it works like part of the page. If GitHub ships a redesign, the kit’s named anchors try their fallbacks first. A warning in Activity (“GitHub+: 2 of 9 anchors stopped matching”) tells you before you find out by clicking.

  2. You want CI state on a pull request before the page has drawn it.

    The kit reads the site’s own JSON responses as they load, from addresses it declared up front, and shows a badge. The page always gets its original response, and nothing is blocked or rewritten.

  3. You want a private note on every pull request, and your own commands.

    The kit keeps the notes in its own storage and shows them in a sidebar, and ⌥⌘K opens a palette inside the page. You edit the CSS or JavaScript in your own editor and the open tab updates when you save.

App Kits

  1. Mail should show a “Make a to-do” button beside the selected message.

    The App Kit pins a small panel to that element. It follows the window as it moves and resizes, hides when Mail is covered or minimised, and never takes focus.

  2. Slack says “3 unread” on its Dock icon and you want a macro to use the 3.

    Every app has a free reading of its Dock badge, {app.badge.Slack}. Use it as a token in any step, as a condition, or as a trigger when the number goes up, and show it in the menu bar as “✉ 3”.

  3. Mail’s Archive should be ⌘E.

    The kit writes Message > Archive: ⌘E into the app’s menu key equivalents. It shows in Mail’s real menus and works with Switchboard quit, and turning the kit off removes exactly the entries it added.

How it works

  1. A kit is a group scoped to a site or an app, with a kit/ folder of styles, scripts, HTML fragments and saved pages for checks.
  2. Anchors name the parts of the page or window the kit attaches to, each with fallbacks. When the site or app updates, Switchboard re-checks them.
  3. A miss opens one Activity row per kit, with Repair with AI, which proposes new selectors and outlines the element before you save. Share a kit as one file; a trust sheet lists what it may read.

Read the docs