Millennium
Helpers

One cross-platform command

Keep Millennium healthy.

Install, diagnose, repair, upgrade, and schedule Millennium from one CLI. File-changing commands support confirmation or a dry run.

Install helpersView v4.0.0

millennium diag

Steam ClientRunning

healthy

Millennium hookActive and verified

healthy

Scheduled updatesEnabled daily

active

3 checks passed · no action required

Runs where Steam runs

Commands

Install, inspect, repair, and update.

Each command reports what changed. Destructive work requires explicit confirmation.

01

Install

millennium install

Set up the CLI and choose how Millennium updates.

02

Diagnose

millennium diag

Inspect Steam, the hook, channels, and scheduled jobs.

03

Repair

millennium doctor

Apply targeted fixes with confirmation and dry-run support.

04

Maintain

millennium upgrade

Update Millennium, roll back a release, and manage themes.

Learn how the helper works

Before files change

Preview the command. Verify the release.

Dry runs show destructive work before it starts. Diagnostics sanitize shared reports. Signed releases include checksums, provenance, and software bills of materials.

Read the security model
One binary
Shared behavior across supported operating systems
Explicit changes
Confirmation and dry-run paths for destructive commands
Verified builds
Checksums, Sigstore bundles, attestations, and SPDX SBOMs

Start on your platform

Install Millennium Helpers.

Millennium Helpers manages an existing Steam installation. Close Steam before you install or repair Millennium.

Recommended on Linux

Run the installer

curl -fsSL https://raw.githubusercontent.com/bolens/millennium-helpers/main/install.sh | bash -s -- install

The installer asks which Millennium channel and update schedule you want.

Recommended on Windows

Install with Scoop

scoop install https://raw.githubusercontent.com/bolens/millennium-helpers/main/packaging/scoop/millennium-helpers-bin.json

You can also run winget install bolens.millenniumhelpers.

After installation, open a new terminal and run millennium --help. If you see the command list, the helpers are ready.

First steps

Check your Millennium setup.

The diagnostic command reads your setup and reports problems. It does not change files.

1

Close Steam

Steam can lock files that Millennium Helpers needs to inspect or replace.

2

Run the health check

millennium diag

Green checks mean that part of your setup is working.

3

Repair reported problems

millennium doctor

Review each proposed change before you confirm it.

Common tasks

Keep Millennium working.

Run these commands in a terminal. Close Steam before an upgrade, repair, or rollback.

Update Millennium

Install the newest version from your selected client channel.

millennium upgrade

Turn on daily updates

Use the stable channel unless you want preview releases.

millennium schedule enable stable

Choose a theme

List installed themes, then select the one you want.

millennium theme list
millennium config theme NAME

Manage plugins

Open the interactive plugin and theme selector.

millennium config plugins

Check scheduled updates

See whether the background updater is installed and active.

millennium schedule status

Get help

Start with the symptom.

Steam starts without Millennium

Close Steam and run millennium diag. If the hook check fails, run millennium doctor.

An update did not finish

Run millennium diag, then retry millennium upgrade. Keep Steam closed until the command finishes.

A theme or plugin causes trouble

Run millennium config plugins and disable the recent change. Restart Steam after you save the selection.

You need to share a report

Run millennium diag --share. The command removes known sensitive fields before it uploads the report. Review the file path shown in the output.

Report a problemAdvanced troubleshooting

Technical documentation

Packaging, automation, or integration?

The repository contains command reference material, package-maintainer notes, MCP setup, release procedures, and contributor guidance.