auto-terminal-profile

June 21, 2026 · View on GitHub

Automatically switch Terminal profiles when macOS dark/light mode changes

auto-terminal-profile demonstration screen recording

Usage

Homebrew

The easiest way to use auto-terminal-profile is to install the auto-terminal-profile Homebrew formula and run it as a Homebrew service:

  1. Install

    brew install patrik-csak/tap/auto-terminal-profile

  2. Import the Terminal profiles you want to use if you haven’t already

  3. Set your preferred dark and light mode profiles:

    auto-terminal-profile config set
    Or set profiles individually 
    auto-terminal-profile config set dark 'Clear Dark'
auto-terminal-profile config set light 'Clear Light'

  4. Enable automatic switching

    brew services start auto-terminal-profile

    The process will run as a macOS launchd agent, and will start automatically on login

    Disable automatic switching 
    brew services stop auto-terminal-profile

npm

You can use the auto-terminal-profile npm package directly, but it doesn’t have built-in background service management

  1. Install

    npm install --global auto-terminal-profile

  2. Set your preferred dark and light mode profiles:

    auto-terminal-profile config set
    Or set profiles individually 
    auto-terminal-profile config set dark 'Clear Dark'
auto-terminal-profile config set light 'Clear Light'

  3. Enable automatic switching

    auto-terminal-profile watch

    The process will continue until you stop it with Ctrl+C