gpuswitch icon
v0.1.0 · MIT

gpuswitch

Switch between integrated, discrete, and auto GPU on Intel Macs. Interactive TUI and scriptable CLI — no daemons, no config.

npm install -g @kud/gpuswitch-cli
v0.1.0
Latest
6
Commands
Intel
Mac only
MIT
Licence
Why gpuswitch

Features

Everything gSwitch did — minus the abandoned app, plus a terminal you already have open.

🖥
Integrated GPU Mode

Force the Intel iGPU for maximum battery life. Ideal for meetings, writing, and long unplugged sessions.

Discrete GPU Mode

Activate the dedicated dGPU for full graphics performance when you need it — rendering, gaming, or external displays.

🤖
Auto Mode

Restore macOS default behaviour, letting the system switch GPUs dynamically based on workload demand.

🎨
Interactive TUI

Arrow-key picker built with Ink and React. Shows your current mode at a glance — pick and confirm with enter.

🔋
Headless Subcommands

Scriptable integrated|discrete|auto|status commands for shell scripts, Raycast, or CI automation.

🛠
Zero Config

Thin wrapper around pmset. No daemons, no background processes, no setup file. Works out of the box.

Get going fast

Quick Start

Install once, then use either the interactive TUI or headless subcommands — switching GPU modes requires sudo.

# 1. Install globally
$ npm install -g @kud/gpuswitch-cli

# 2. Open the interactive TUI (arrow keys + enter)
$ gpuswitch

  GPU Mode
  current: auto

❯ integrated  integrated GPU only — best battery life
  discrete     discrete GPU only — full performance
  auto         let macOS decide automatically

  ↑↓ navigate · enter apply · q quit

# 3. Or go straight to a mode (prompts for sudo)
$ gpuswitch integrated
GPU mode set to: integrated

# Check what's active
$ gpuswitch status
current GPU mode: integrated
Commands

CLI Reference

Run without arguments for the interactive TUI, or pass a subcommand for headless use in scripts and automation.

gpuswitch Open interactive TUI mode — navigate with ↑↓, confirm with enter
gpuswitch integrated Switch to integrated GPU only — best for battery life
gpuswitch discrete Switch to discrete GPU only — full graphics performance
gpuswitch auto Let macOS manage GPU switching automatically
gpuswitch status Print the current GPU mode to stdout
gpuswitch --help Show usage and available commands