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.

Uninstalling Aurora Shell removes all theme files, settings, and installed binaries from your machine, and cleans up any entries that were added to your shell profile during installation. After uninstalling, your terminal will return to its default appearance — the Aurora banner, stats bar, and rainbow prompt will no longer appear on session start.

​
Quick Uninstall (via shell.aurora)

The recommended way to uninstall is using the built-in --uninstall flag. This method is available as long as Aurora is currently active in your shell session. 
shell.aurora --uninstall
On macOS, this command runs the following cleanup steps:
  • Deletes the entire ~/.aurora-shell_files directory with rm -rf ~/.aurora-shell_files
  • Removes the source line pointing to the Aurora theme from ~/.zshrc
On Windows, this command runs the following cleanup step:
  • Deletes the installation directory with Remove-Item "$HOME\.aurora-shell" -Recurse -Force
Note that the Windows --uninstall flag does not automatically clean your PowerShell $PROFILE. After running it, open your profile file (notepad $PROFILE) and manually remove the line that sources Aurora’s .ps1 files from ~\.aurora-shell_files.

​
Manual Uninstall (without shell.aurora)

If the shell.aurora (or aurora) command is no longer available — for example, if your shell profile was already modified or the theme file is missing — you can run the cleanup commands directly in your terminal. 
rm -rf ~/.aurora-shell_files
sed -i '' '/aurora-shell_theme/d' ~/.zshrc
These commands perform the same cleanup as the built-in --uninstall flag and are safe to run even if Aurora is only partially installed.

​
What Gets Removed

The following items are deleted during a standard uninstall:
  • ~/.aurora-shell_files/ — the main installation directory, containing all theme files, the settings file, installed binaries (in bin/), the packages registry (packages.json), and any account session data
  • macOS — the source ~/.aurora-shell_files/aurora-shell_theme line is removed from ~/.zshrc
  • Windows — all Aurora-related entries are removed from your PowerShell $PROFILE, specifically lines matching aurora, Get-AuroraStats, and Show-Aurora

​
After Uninstalling

Once uninstalled, restart your terminal to apply the changes. The Aurora banner, diagnostic stats bar, and rainbow prompt will no longer appear. Your default shell prompt and profile settings will be restored. If you had signed in to an Aurora Account, the local session file (active_account.json) is also removed as part of the ~/.aurora-shell_files directory cleanup.
Uninstalling Aurora Shell does not remove Homebrew packages that were installed during setup (such as lolcat, figlet, and pygments) or any developer tools you opted into during the configuration wizard (Node.js, Python, Docker, etc.). These are managed by your system package manager and must be removed manually if you no longer need them.

Build docs developers (and LLMs) love

Get started for freeTalk to us