jacklandrin/onlyswitch

★ 5,667SwiftAudience · generalComplexity · 1/5LicenseSetup · easy

Mindmap

mindmap
  root((OnlySwitch))
    What it does
      Menu bar toggles
      One-click settings
      Desktop widgets
    Built-in switches
      Dark mode
      Mic mute
      Screen awake
      Pomodoro timer
    Power features
      Apple Shortcuts import
      Keyboard shortcuts
      Only Agent AI
    Install
      Homebrew
      Direct download

mindmap root((OnlySwitch)) What it does Menu bar toggles One-click settings Desktop widgets Built-in switches Dark mode Mic mute Screen awake Pomodoro timer Power features Apple Shortcuts import Keyboard shortcuts Only Agent AI Install Homebrew Direct download

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Toggle dark mode, mute your mic, or keep your screen awake from the menu bar without opening System Preferences

USE CASE 2

Add imported Apple Shortcuts as custom one-click switches to automate routine Mac tasks

USE CASE 3

Use the built-in Pomodoro timer or eject discs and clear the clipboard without leaving your current app

USE CASE 4

Type plain English commands to run AppleScripts via the Only Agent AI feature on macOS 26 or later

Tech stack

SwiftmacOSApple ShortcutsAppleScriptOllamaOpenAI API

Getting it running

Difficulty · easy Time to first run · 5min

Only Agent AI feature requires macOS 26 or later.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

OnlySwitch is a macOS menu bar app that puts a collection of quick-toggle switches into a single dropdown, so you can flip common settings on and off without digging through System Preferences. The app lives in the top status bar of your Mac and gives you one-click access to things like dark mode, hiding the desktop, muting your microphone, keeping your screen awake, controlling Bluetooth, and even hiding the notch on newer MacBook Pro models. The switch list is long and covers a wide range of tasks: clearing your pasteboard or trash, running a Pomodoro timer, dimming the screen, ejecting discs, toggling Spotify or Apple Music playback, and more. You can customise which switches appear in the list and reorder them to fit your workflow. Many of these toggles can also be placed as widgets directly on your desktop if you are running macOS Sonoma or later. From version 1.7 onward, the app supports importing Apple Shortcuts, and a community gallery lets users share and discover ready-made Shortcuts to add to their setup. Keyboard shortcuts were added in version 2.0, so you can control all switches without touching your mouse. A newer feature called Only Agent, added in version 2.6.0, lets you type plain English instructions and the app uses an AI model to generate and run an Apple Script on your Mac. It works with Ollama, OpenAI, and Gemini as model providers, and requires macOS 26 or later. The app is free, open source under the MIT license, and can be installed via Homebrew or as a direct download. It supports over a dozen languages. The developer accepts optional donations to keep development going.

Copy-paste prompts

Prompt 1

How do I install OnlySwitch via Homebrew and set up keyboard shortcuts for my most-used toggles like dark mode and mic mute?

Prompt 2

I want to import an Apple Shortcut into OnlySwitch as a custom switch, walk me through the steps to add it to my menu bar

Prompt 3

Write an AppleScript I can use with OnlySwitch's Only Agent feature to toggle Do Not Disturb mode on macOS

Prompt 4

How do I contribute a new toggle switch to the OnlySwitch Swift open-source codebase, what protocol do I implement?

Prompt 5

How do I connect OnlySwitch's Only Agent to a local Ollama model instead of OpenAI for privacy?

Open on GitHub → Explain another repo

← jacklandrin on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.