CPU Eco Toggle Get it on GitHub
Windows · PowerShell

One click gives a pinned CPU room to breathe

A Windows tray switch that moves windowless background jobs onto fewer cores at lower priority. Nothing is stopped; one more click restores them.

Windows · PowerShell
cpu-eco-toggle · illustrationillustration
CPU Eco Toggle screenshot
2platforms: Windows, PowerShell
MITopen source licence
Why it exists

A pinned CPU, without killing anything.

When AI agents, builds, local LLMs and long Python jobs pin the CPU at 100%, the PC you are sitting at turns sluggish.

Switched ON, it moves background workloads to fewer CPU cores (5 of 8 on an 8-core machine) and sets them to BelowNormal priority.

How it works

From script to taskbar switch

  1. 1

    Install

    Run install_eco_toggle.ps1.

  2. 2

    Pin it

    Start, CPU Eco Toggle, right-click, Pin to taskbar.

  3. 3

    Switch

    Click the tray icon or the pinned button to switch between ON and OFF.

What's inside

What one click changes.

One click, two states

A green tray icon means ON, grey means OFF. Left-click to switch. Hover to see the live state, CPU % and RAM %.

Nothing is stopped

It only changes CPU affinity and priority. Every job keeps running; it just shares the machine more politely.

What you see stays fast

Processes with a visible window are skipped, only headless Edge counts, and anything Vector started is never touched.

Catches new jobs

While ON it picks up new background processes every 30 s. Child processes such as rustc inherit the limit from their parent, and OFF releases them too.

Exact restore

It records each process's original priority and cores, so OFF or Exit puts every one back the way it was.

A taskbar button

Launching it again while it runs toggles the running copy, so a pinned taskbar shortcut works as an on/off switch.

Memory trim on demand

Right-click, Trim background memory now releases RAM from windowless background processes; pages reload on demand.

Run it yourself

Install it in one line.

From the README’s “Install” section. Full options, requirements and troubleshooting are there too.

Open the README
powershell
$ powershell -ExecutionPolicy Bypass -File install_eco_toggle.ps1
Good to know

Honest limits.

Straight from the README, so you know what you're getting before you try it.

  • Windows only: Windows PowerShell 5.1 and WinForms.
  • Limits only processes named opencode, cargo, rustc, ollama, llama-server, python and pythonw, plus headless msedge.
  • Affinity and priority last until a process restarts.
  • If the icon is hidden behind the tray arrow, drag it onto the taskbar.
Under the hood

How it's built.

Built with

Language
PowerShellHTML/CSS

6 files in the repo · last updated 12 Nov 2026.

Browse the code

Recently shipped

  1. Add demo page (illustration of tray menu, tooltip and notification) for GitHub Pages

  2. Tray on/off switch that limits background CPU without stopping processes

Full history on GitHub
Questions

Good questions.

How do I get it running?

The commands in the “Install” box above come straight from the README. Paste them into a terminal; the README covers options and troubleshooting.

What doesn't it do yet?

Windows only: Windows PowerShell 5.1 and WinForms. Limits only processes named opencode, cargo, rustc, ollama, llama-server, python and pythonw, plus headless msedge.

Is it free?

The source is public on GitHub under the MIT licence.

Who made it?

Juwen Lie, an R&D mechanical engineer in Batam, Indonesia, as an independent personal project.

Keep exploring

More from the same workbench.

Get it on GitHub.

One click gives a pinned CPU room to breathe