Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Seaus-tech/Aurora-Shell/llms.txt

Use this file to discover all available pages before exploring further.

Aurora Shell has a built-in update system that works on both macOS and Windows. Every time you open a new terminal session, the theme checks the remote repository for a newer version and prompts you to upgrade if one is available. You can also trigger an update manually at any time using the --update flag, or perform a full clean reinstall by re-running the original installer.

​
Automatic Version Check

On every terminal open, the Aurora theme file fetches the remote installer from GitHub and extracts the current version string: 
curl -sf "https://raw.githubusercontent.com/Seaus-tech/Aurora-Shell/dev/install.sh"
This value is compared against the AURORA_VER field stored in your local settings file (aurora-shell_settings on macOS, aurora-shell_settings.ps1 on Windows). If the remote version is newer than your installed version, Aurora displays a prompt before your session loads: 
🔔 Aurora-Shell wants to update (v5.6.1 → v5.6.2) [y/N]:
Answering y automatically runs shell.aurora --update dev, pulling the latest installer from the dev branch and applying it. Answering N (or pressing Enter) skips the update and continues loading your session normally.

​
Manual Update

You can trigger an update at any point from your terminal using the --update flag. An optional second argument specifies the branch to pull from — it defaults to main if omitted. 
shell.aurora --update
# or update from a specific branch:
shell.aurora --update dev
When you run --update, Aurora downloads the installer script from the specified branch and executes it in place. Your PIN and existing settings are preserved through the update process.

​
Re-Running the Full Installer

For a clean reinstall — for example, after a major version jump or if your theme files become corrupted — you can re-run the original one-line installer. This will remove the existing ~/.aurora-shell_files directory, recreate all theme and settings files, and re-source the theme in your shell profile. 
bash <(curl -s https://raw.githubusercontent.com/Seaus-tech/Aurora-Shell/main/install.sh)
The installer will walk you through the configuration wizard again, allowing you to set a new PIN, choose a header style, and optionally sign in to your Aurora Account.

​
Current Versions

PlatformLatest Version
macOS (Zsh)v5.6.2
Windows (PowerShell 7+)v5.5.7
The version number is stored in the AURORA_VER variable in your settings file and is displayed in the stats bar shown at the start of every terminal session.
The --update command pulls a fresh copy of the installer from GitHub and runs it against your existing installation. Your PIN and settings (header mode, prompt ID, birthday, and account credentials) are preserved throughout the update — you will not be asked to reconfigure Aurora unless you run a full reinstall.

Build docs developers (and LLMs) love

Get started for freeTalk to us