📦 ARO Command-Line Interface
The ARO CLI lets you run, build, compile, and test ARO applications. Download the pre-built binary for your platform or build from source.
Install with Homebrew
Recommended for macOSThe easiest way to install ARO on macOS. Homebrew handles updates and dependencies automatically.
brew tap arolang/aro brew install aro
Or download a pre-built binary:
macOS
Universal binary for Apple Silicon and Intel Macs
Download for macOS aro-macos-universal.tar.gzLinux
64-bit binary for Ubuntu, Debian, and other distributions
Download for Linux aro-linux-x86_64.tar.gzBuild from Source
Alternatively, build ARO from source using Swift:
git clone https://github.com/arolang/aro.git cd aro swift build -c release # Binary is at .build/release/aro
Requires Swift 6.2 or later.
📖 Documentation
Learn ARO with our comprehensive documentation series covering philosophy, syntax, patterns, and practical examples.
The Language Guide
Comprehensive guide to ARO: from mental model to native compilation
Download PDF ARO-Language-Guide.pdfARO By Example
Learn by doing: practical examples and hands-on tutorials
Download PDF ARO-By-Example.pdfConstruction Studies
Deep dives into ARO internals and advanced implementation patterns
Download PDF ARO-Construction-Studies.pdfThe Plugin Guide
Build plugins in Swift, Rust, C, and Python to extend ARO
Download PDF ARO-Plugin-Guide.pdf📝 IDE Extensions
Enhance your ARO development experience with syntax highlighting and code snippets.
Visual Studio Code
Full syntax highlighting and smart snippets for VS Code.
- Syntax highlighting for all ARO elements
- 40+ code snippets for common patterns
- Bracket matching and auto-closing
- Code folding for feature sets
IntelliJ IDEA
TextMate-based highlighting with live templates for JetBrains IDEs.
- Syntax highlighting via TextMate
- Live templates for quick coding
- Works with all JetBrains IDEs
- File type association
Manual Installation: Extensions are also available in the Editor directory of the GitHub repository.
🚀 Quick Start
After installing, verify your installation and run your first ARO application:
# Check version aro --version # Run an example aro run ./Examples/HelloWorld # Run tests aro test ./Examples/Calculator # Compile to native binary aro build ./Examples/HelloWorld
Ready to learn more? Check out the Getting Started Guide or dive into the Tutorial.