Time to ship · about 3 minutes
Install Aura.
Three paths to get Aura running on macOS: drop the DMG, use Homebrew, or run the one-line install script. Pick the one that fits your workflow.
Aura requires macOS 12 or later. The Swift app is the desktop surface, and the local CLI engine handles voice, context, and worker dispatch. Live voice needs either a managed Aura token or a provider key; Codex and Claude Code keep using their own local logins.
DMG — drag to Applications.
Download the latest Aura.dmg from the releases page, open it, and drag Aura.app into Applications. On first launch, Aura shows the splash first, then the setup screen where microphone access is requested. Accessibility remains optional, and Speech Recognition appears only if you choose Hot Mic.
Signed and notarized
The release DMG is Developer ID-signed, notarized, stapled, and Gatekeeper-checked in CI before upload. If macOS shows a warning, verify the download hash against the release page.
Homebrew — one command.
If you manage your tools with Homebrew, install from the Codexini tap. This also sets up standard updates via brew upgrade and installs the Swift app as aura-swift.
brew tap XoAnonXo/codexini https://github.com/XoAnonXo/codexini brew install aura
Install script — from Claude Code or a terminal.
The one-liner works from any terminal or from a Claude Code chat window. Pass --target claude for Claude Code dispatch or --target codex for Codex CLI dispatch.
bash <(curl -fsSL https://codexini.com/install) --target claude
The script checks system requirements, installs the CLI engine and Swift app when a signed release payload is available, runs aura doctor to verify readiness, and explains each permission before asking for it. Nothing opens in a browser unless you consent.
Verify the install.
After any install path, run the readiness check. It confirms audio devices, config, worker auth, and tool count in one pass.
$aura doctor
A clean output shows all items passing. If microphone access is missing, the doctor will tell you which System Settings pane to open.