Auto Terminal Profile

Automatically switch macOS Terminal profiles when the dark / light appearance mode changes

Prerequisites

• Node.js 18–20

Installation

npm install --global auto-terminal-profile

Usage

Enable automatic profile switching

To get started, enable automatic profile switching and set your preferred dark and light mode profiles:

auto-terminal-profile enable \
  --dark-profile='One Dark' \
  --light-profile='One Light'

Switch profile on Terminal startup

Auto Terminal Profile only runs if Terminal is running, so the profile can fall out of sync if the macOS appearance mode changes while Terminal isn’t running.

To sync the Terminal profile to the current macOS appearance mode once:

auto-terminal-profile update-profile

To sync the Terminal profile to the current macOS appearance mode when Terminal app is opened, you can add that line to your shell startup script (e.g. .zshrc), but it will increase the startup time of new shell sessions.

Disable automatic profile switching

auto-terminal-profile disable

Help

auto-terminal-profile --help