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.

The CLI command is Aurora Shell’s dedicated installer for developer CLI tools. Once installed, it provides one-command access to 38+ popular tools spanning cloud platforms, containers, databases, deployment services, AI APIs, and more. Every invocation fetches the latest package list from GitHub, so the catalog stays current without requiring a full Aurora Shell update.

Installation

Install the CLI command through the Aurora Shell package manager:
shell install CLI
This writes the CLI script to ~/.aurora-shell_files/bin/CLI and marks it executable. Because ~/.aurora-shell_files/bin is on $PATH, the CLI command is immediately available in any new shell session.

CLI install <package>

Installs a CLI tool using Homebrew (macOS) or winget (Windows) under the hood. Accepts both full package IDs and aliases. Syntax
CLI install <package>
Examples
CLI install GitHub.CLI
CLI install Docker.CLI
CLI install Kubernetes.CLI

# Aliases work too
CLI install gh        # resolves to GitHub.CLI
CLI install k8s       # resolves to Kubernetes.CLI
CLI install claude    # resolves to Anthropic.CLI
Install flow
  1. The package list is fetched from GitHub and saved to ~/.aurora-shell_files/cli-packages.json.
  2. The alias is resolved to a full package ID.
  3. The install command from the registry is executed (e.g., brew install gh).
  4. A spinner runs while the install completes.
  5. On success, the installed command name is confirmed.
📦 Installing GitHub.CLI CLI...
user@host ~ % brew install gh
✅ GitHub.CLI CLI installed: gh

CLI list

Prints all packages available in the registry, showing each package’s full ID, command name, and description. Syntax
CLI list
Example output
📋 Available CLI packages:
  GitHub.CLI (gh) - GitHub CLI
  Amazon.AWS (aws) - Amazon Web Services CLI
  Microsoft.Azure (az) - Microsoft Azure CLI
  Docker.CLI (docker) - Docker container CLI
  Kubernetes.CLI (kubectl) - Kubernetes CLI
  ...
See the CLI Packages Catalog for the full list.

CLI search <query>

Performs a case-insensitive search of package IDs and aliases in the registry and prints matching results in a formatted table. Syntax
CLI search <query>
Examples
CLI search docker
CLI search cloud
CLI search aws
Example output
🔍 Searching CLI packages for: docker

Name                      ID                        Version    Source
------------------------- ------------------------- ---------- ------
Docker container CLI      Docker.CLI                29.4.1     brew

Package Sources

Each registry entry declares a source field that tells the CLI installer which tool to use:
SourceInstall mechanism
brewbrew install <formula> (macOS)
npmnpm install -g <package>
pippip3 install <package>
pipxpipx install <package>
kiro.devCustom URL — curl -fsSL https://cli.kiro.dev/install | bash
auroraCustom install script embedded in the registry

Keeping Packages Updated

The CLI package list is always fetched fresh from the Aurora Shell GitHub repository on each CLI install or CLI list invocation:
curl -sf "https://raw.githubusercontent.com/Seaus-tech/Aurora-Shell/dev/cli-packages.json"
The fetched file is stored locally at ~/.aurora-shell_files/cli-packages.json. If the fetch fails (e.g., no network), the locally cached copy is used as a fallback.

Full Package Catalog

For the complete list of all 38+ available packages organized by category with versions, aliases, and install commands, see the CLI Packages Catalog.

Build docs developers (and LLMs) love