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 is a sleek, high-performance terminal theme and diagnostic dashboard built for developers who want more from their command line. Designed for macOS (Zsh) and Windows (PowerShell 7+), Aurora transforms every terminal session into an informative, visually rich experience — displaying live system stats, a colorful rainbow prompt, and an ASCII art banner the moment you open a new window. Whether you’re a solo developer, part of a team, or just someone who spends hours a day in the terminal, Aurora Shell makes that environment both functional and beautiful.

​
Key Features

Diagnostics Dashboard

Every terminal open displays real-time CPU usage, free disk space, battery level (macOS), and today’s date — centered beneath a full-width ASCII art banner. No extra commands needed.

Session Lock

Protect your terminal with a PIN stored securely in macOS Keychain. When locked, Aurora displays the encrypted-terminal ASCII art and requires your PIN before granting access to the shell.

Package Manager

The built-in shell command lets you install, search, list, add, and remove packages from the Aurora registry or fall back to Homebrew (macOS) and winget (Windows) automatically.

CLI Installer

Run shell install CLI to get the Aurora CLI tool, then use CLI install <package> to install developer CLIs like GitHub CLI, AWS, Azure, Docker, kubectl, Terraform, and many more.

AI Assistant (Auseaia)

The auseaia command gives you an AI assistant directly in your terminal — ask questions, explain shell concepts, and debug commands without ever leaving your workflow.

Cross-Platform Support

Aurora Shell runs on both macOS (Zsh) and Windows (PowerShell 7+). The installers, theme engines, package registries, and diagnostics are all tailored to each platform’s native tools.

​
How It Works

Aurora Shell is installed with a single command that runs a configuration wizard, installs dependencies, and generates a theme file. On macOS, the installer writes the theme to ~/.aurora-shell_files/aurora-shell_theme and appends a source line to your ~/.zshrc: 
source ~/.aurora-shell_files/aurora-shell_theme
On Windows, the installer writes aurora-shell_theme.ps1 to $HOME\.aurora-shell_files\ and dot-sources all .ps1 files in that directory from your PowerShell $PROFILE: 
Get-ChildItem "$HOME\.aurora-shell_files\*.ps1" | ForEach-Object { . $_.FullName }
Every time you open a new terminal, the theme file runs automatically. It reads your saved settings from aurora-shell_settings (or aurora-shell_settings.ps1 on Windows), authenticates you if a PIN is set, renders the ASCII art banner via the Show-Aurora function, collects live telemetry (CPU, disk, battery), and sets the rainbow prompt. The shell.aurora and shell functions are also loaded, making the full command surface available in every session.

​
Version Support

Aurora Shell follows a per-platform versioning scheme. The current releases are:
PlatformCurrent Version
macOS (Zsh)v5.6.2
Windows (PowerShell 7+)v5.5.7
It is strongly recommended to run the latest version on your platform. To update, run shell.aurora --update at any time.
macOS requires lolcat, figlet, and pygments for the rainbow banner, ASCII art header, and syntax highlighting. The installer installs all three automatically via Homebrew (brew install figlet lolcat pygments). Without them, Aurora falls back to plain output.Windows requires PowerShell 7+ (pwsh). Windows PowerShell 5.1 is not supported and will not work with Aurora Shell.

Build docs developers (and LLMs) love

Get started for freeTalk to us