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, cross-platform terminal enhancement for macOS (Zsh) and Windows (PowerShell 7+). Every time you open a terminal, Aurora greets you with an ASCII art banner, live CPU/disk/battery diagnostics, and a vibrant rainbow gradient prompt. Beyond the theme, Aurora ships a full command center — shell.aurora — for managing your session lock, updating the theme, and controlling your Aurora account.

Installation

Install Aurora Shell on macOS or Windows in one command

Quickstart

Get Aurora running and explore its features in minutes

Configuration

Customize your header, PIN, prompt ID, and birthday greeting

Command Reference

Every shell.aurora flag, the package manager, and the CLI installer

What Aurora Shell Does

Diagnostics Dashboard

CPU usage, free disk space, battery level, and date shown on every terminal open

Session Lock

PIN-protected lock screen backed by macOS Keychain — engage with shell.aurora --lock

Package Manager

Install, search, and manage packages with the built-in shell command

CLI Installer

One-liner installs for 38+ developer CLIs — GitHub, AWS, Docker, Kubernetes, and more

AI Assistant

Auseaia runs Llama3 locally via Ollama for in-terminal AI help

Dev Tools Bootstrap

Optionally install Git, Node, Python, Go, Rust, Docker, and cloud CLIs during setup

Get Up and Running

1

Install Aurora Shell

macOS:
bash <(curl -s https://raw.githubusercontent.com/Seaus-tech/Aurora-Shell/main/install.sh)
Windows (PowerShell 7+):
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/Seaus-tech/Aurora-Shell/main/install.ps1'))
2

Complete the configuration wizard

The installer walks you through setting a PIN, choosing a header style (Mega-Block or custom figlet), setting a prompt ID, and optionally creating an Aurora account.
3

Restart your terminal

After installation, restart your terminal (or run zsh on macOS) to activate the Aurora theme. You’ll see the diagnostics banner immediately.
4

Explore the command center

Run shell.aurora with no arguments to see all available commands, or jump straight to shell install CLI to get the CLI package installer.
macOS requires lolcat and figlet for colorful output. The installer will set these up automatically via Homebrew. Windows uses the built-in PowerShell color engine.

Build docs developers (and LLMs) love